<!-- Hero Section -->
<div align="center">
<!-- Logo -->
<div align="center" style="background-color: #000; padding: 1em; display: inline-block; border-radius: 8px;">
<img
src="https://atlasserver.vercel.app/static/svg/atlas.svg"
alt="AtlasServer Logo"
width="200"
style="display: block;"
/>
</div>
<!-- Main Title -->
<h1 style="margin-top: 0.5em; font-size: 3rem; color: #2d3748;">
AtlasServerβCore
</h1>
<!-- Tagline -->
<p style="font-size: 1.25rem; color: #4a5568; line-height: 1.5;">
π» <strong>Fast deploy. No cloud. Just code.</strong><br />
<em>From developers to developers.</em>
</p>
<!-- PyPI and GitHub Badges -->
<p align="center">
<a href="https://pypi.org/project/atlasserver/"><img src="https://img.shields.io/pypi/v/atlasserver.svg" alt="PyPI Version"></a>
<a href="https://pypi.org/project/atlasserver/"><img src="https://img.shields.io/pypi/pyversions/atlasserver.svg" alt="Python Versions"></a>
<a href="https://pypi.org/project/atlasserver/"><img src="https://img.shields.io/pypi/dm/atlasserver" alt="PyPI Downloads"></a>
<a href="https://github.com/AtlasServer-Core/AtlasServer-Core/"><img src="https://img.shields.io/github/stars/AtlasServer-Core/AtlasServer-Core.svg" alt="GitHub Stars"></a>
<a href="https://github.com/AtlasServer-Core/AtlasServer-Core/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License"></a>
<!--<a href="https://github.com/AtlasServer-Core/AtlasServer-Core/"><img src="https://img.shields.io/endpoint?url=https://git-echo.vercel.app/api/v1/gitecho/d0105a3f-aae8-479c-a772-96e5402e4bc3/AtlasServer-Core/AtlasServer-Core/clones" alt="Clones"></a>-->
</p>
<p align="center">
<img
src="https://res.cloudinary.com/dmtomxyvm/image/upload/v1746656451/sprrvldk6kn4udtfuq3m.png"
alt="AtlasServer Dashboard"
width="80%"
/>
</p>
<!-- Divider -->
<hr style="width: 50px; border: 2px solid #2d3748; margin: 1.5em auto;" />
</div>
### βοΈ Current Features
- **Supported frameworks**: `Flask`, `FastAPI`, `Django` and `Django REST Framework`
- **Tunneling**: Support for `Ngrok`
- **Admin panel**: Basic web interface to manage applications
- **App management**: Start, stop, and delete applications from the panel
- **Command Line Interface**: Manage server and applications from the terminal
- **Authentication**: Basic authentication system with limited roles
- **AI-powered deployment**: Intelligent project analysis and deployment suggestions
---
### π Quick Start
```bash
# Install AtlasServer from PyPI
pip install atlasserver
# Optional: Install AI capabilities
pip install atlasai-cli
# Start the server
atlasserver start
# Access the web interface at http://localhost:5000
# Default credentials: Create your own admin account on first run
# List all applications from CLI
atlasserver app list
```
### π» CLI Commands
AtlasServer includes a powerful CLI for easier management:
```bash
# Server management
atlasserver start # Start the server
atlasserver stop # Stop the server
atlasserver status # Check server status
# Application management
atlasserver app list # List all applications
atlasserver app start APP_ID # Start an application
atlasserver app stop APP_ID # Stop an application
atlasserver app restart APP_ID # Restart an application
atlasserver app info APP_ID # Show application details
```
#### Optional AI Commands (requires atlasai-cli)
```bash
# AI configuration
atlasserver ai setup --model llama3:8b # Configure with local Ollama model
atlasserver ai setup --provider openai --model gpt-4.1 --api-key YOUR_KEY # Use OpenAI
# Project analysis
atlasserver ai suggest ~/path/to/your/project # Get deployment suggestions
atlasserver ai suggest ~/my-project --language es # Get suggestions in Spanish
# General AI queries
atlasai --query "What files are in this project?" # Simple query
atlasai --query "How can I deploy this Express app?" --language es # Query in Spanish
atlasai --query "Compare this project's dependencies with best practices" # Complex analysis
```
### π€ AI-Powered Deployment (Optional)
AtlasServer supports intelligent project analysis through the optional **AtlasAI-CLI** package:
- **Smart project detection**: Automatically identifies Flask, FastAPI, Django and other frameworks
- **Contextual recommendations**: Suggests appropriate commands, ports, and environment variables
- **Interactive exploration**: Analyzes project structure and key files
- **Multilingual support**: Get explanations in English or Spanish
- **General AI queries**: Ask anything about your system, projects, or development needs
**Installation:**
```bash
# Install the optional AI capabilities
pip install atlasai-cli
# Alternatively, install both AtlasServer and AI capabilities
pip install atlasserver atlasai-cli
```
**Requirements:**
- [Ollama](https://github.com/ollama/ollama) for running local AI models
- Alternatively, OpenAI API for cloud-based models
**Setup:**
```bash
# Install and start Ollama (for local models)
ollama serve
# Pull your preferred model
ollama pull llama3:8b
# Configure AtlasServer AI
atlasserver ai setup --model llama3:8b
# Analyze a project
atlasserver ai suggest ~/path/to/your/project
# Make a general query about your system or projects
atlasai --query "What projects do I have here and how should I deploy them?"
```
### π§ Development Installation
If you want to contribute to AtlasServer or install from source:
```bash
# Clone the repository
git clone https://github.com/AtlasServer-Core/AtlasServer-Core.git
cd AtlasServer-Core
# Install in development mode
pip install -e .
```
---
### π’ Join the Beta
We're running a **3β4 week closed beta** to refine usability, tunnel stability, and overall workflow.
π **Join our Discord** for beta access, discussions, and direct feedback:
[](https://discord.gg/QedUbbQpK9)
---
### π License
This project is licensed under the **Apache License 2.0**.
[](https://www.apache.org/licenses/LICENSE-2.0)
You may obtain a copy of the License at:
`http://www.apache.org/licenses/LICENSE-2.0`
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an **"AS IS" BASIS**,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the [full license text](LICENSE) for details.
## Star History
[](https://www.star-history.com/#AtlasServer-Core/AtlasServer-Core&Date)
### π THANK YOU FOR YOUR STARS!!
## π Support the Project
If you find AtlasServer-Core useful, please consider buying me a coffee:
[](https://buymeacoffee.com/atlasserver)
Raw data
{
"_id": null,
"home_page": null,
"name": "atlasserver",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "flask, fastapi, django, deploy, demo",
"author": null,
"author_email": "AtlasServer-Core / Fredy <riveraaai200678@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/a2/e5/c06b1d89e371f3edbb1986ca07f769cac91758342b2a951645a082b73491/atlasserver-0.3.5.tar.gz",
"platform": null,
"description": "<!-- Hero Section -->\n<div align=\"center\">\n\n <!-- Logo -->\n <div align=\"center\" style=\"background-color: #000; padding: 1em; display: inline-block; border-radius: 8px;\">\n <img\n src=\"https://atlasserver.vercel.app/static/svg/atlas.svg\"\n alt=\"AtlasServer Logo\"\n width=\"200\"\n style=\"display: block;\"\n />\n </div>\n\n\n <!-- Main Title -->\n <h1 style=\"margin-top: 0.5em; font-size: 3rem; color: #2d3748;\">\n AtlasServer\u2011Core\n </h1>\n\n <!-- Tagline -->\n <p style=\"font-size: 1.25rem; color: #4a5568; line-height: 1.5;\">\n \ud83d\udcbb <strong>Fast deploy. No cloud. Just code.</strong><br />\n <em>From developers to developers.</em>\n </p>\n\n <!-- PyPI and GitHub Badges -->\n <p align=\"center\">\n <a href=\"https://pypi.org/project/atlasserver/\"><img src=\"https://img.shields.io/pypi/v/atlasserver.svg\" alt=\"PyPI Version\"></a>\n <a href=\"https://pypi.org/project/atlasserver/\"><img src=\"https://img.shields.io/pypi/pyversions/atlasserver.svg\" alt=\"Python Versions\"></a>\n <a href=\"https://pypi.org/project/atlasserver/\"><img src=\"https://img.shields.io/pypi/dm/atlasserver\" alt=\"PyPI Downloads\"></a>\n <a href=\"https://github.com/AtlasServer-Core/AtlasServer-Core/\"><img src=\"https://img.shields.io/github/stars/AtlasServer-Core/AtlasServer-Core.svg\" alt=\"GitHub Stars\"></a>\n <a href=\"https://github.com/AtlasServer-Core/AtlasServer-Core/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\" alt=\"License\"></a>\n <!--<a href=\"https://github.com/AtlasServer-Core/AtlasServer-Core/\"><img src=\"https://img.shields.io/endpoint?url=https://git-echo.vercel.app/api/v1/gitecho/d0105a3f-aae8-479c-a772-96e5402e4bc3/AtlasServer-Core/AtlasServer-Core/clones\" alt=\"Clones\"></a>-->\n </p>\n\n <p align=\"center\">\n <img\n src=\"https://res.cloudinary.com/dmtomxyvm/image/upload/v1746656451/sprrvldk6kn4udtfuq3m.png\"\n alt=\"AtlasServer Dashboard\"\n width=\"80%\"\n />\n </p>\n\n <!-- Divider -->\n <hr style=\"width: 50px; border: 2px solid #2d3748; margin: 1.5em auto;\" />\n\n</div>\n\n\n\n\n### \u2699\ufe0f Current Features\n\n- **Supported frameworks**: `Flask`, `FastAPI`, `Django` and `Django REST Framework`\n- **Tunneling**: Support for `Ngrok`\n- **Admin panel**: Basic web interface to manage applications\n- **App management**: Start, stop, and delete applications from the panel\n- **Command Line Interface**: Manage server and applications from the terminal\n- **Authentication**: Basic authentication system with limited roles\n- **AI-powered deployment**: Intelligent project analysis and deployment suggestions\n\n---\n\n### \ud83d\ude80 Quick Start\n\n```bash\n# Install AtlasServer from PyPI\npip install atlasserver\n\n# Optional: Install AI capabilities\npip install atlasai-cli\n\n# Start the server\natlasserver start\n\n# Access the web interface at http://localhost:5000\n# Default credentials: Create your own admin account on first run\n\n# List all applications from CLI\natlasserver app list\n```\n\n### \ud83d\udcbb CLI Commands\n\nAtlasServer includes a powerful CLI for easier management:\n\n```bash\n# Server management\natlasserver start # Start the server\natlasserver stop # Stop the server\natlasserver status # Check server status\n\n# Application management\natlasserver app list # List all applications\natlasserver app start APP_ID # Start an application\natlasserver app stop APP_ID # Stop an application\natlasserver app restart APP_ID # Restart an application\natlasserver app info APP_ID # Show application details\n```\n\n#### Optional AI Commands (requires atlasai-cli)\n\n```bash\n# AI configuration\natlasserver ai setup --model llama3:8b # Configure with local Ollama model\natlasserver ai setup --provider openai --model gpt-4.1 --api-key YOUR_KEY # Use OpenAI\n\n# Project analysis\natlasserver ai suggest ~/path/to/your/project # Get deployment suggestions\natlasserver ai suggest ~/my-project --language es # Get suggestions in Spanish\n\n# General AI queries\natlasai --query \"What files are in this project?\" # Simple query\natlasai --query \"How can I deploy this Express app?\" --language es # Query in Spanish\natlasai --query \"Compare this project's dependencies with best practices\" # Complex analysis\n```\n\n### \ud83e\udd16 AI-Powered Deployment (Optional)\n\nAtlasServer supports intelligent project analysis through the optional **AtlasAI-CLI** package:\n\n- **Smart project detection**: Automatically identifies Flask, FastAPI, Django and other frameworks\n- **Contextual recommendations**: Suggests appropriate commands, ports, and environment variables\n- **Interactive exploration**: Analyzes project structure and key files\n- **Multilingual support**: Get explanations in English or Spanish\n- **General AI queries**: Ask anything about your system, projects, or development needs\n\n**Installation:**\n```bash\n# Install the optional AI capabilities\npip install atlasai-cli\n\n# Alternatively, install both AtlasServer and AI capabilities\npip install atlasserver atlasai-cli\n```\n\n**Requirements:**\n- [Ollama](https://github.com/ollama/ollama) for running local AI models\n- Alternatively, OpenAI API for cloud-based models\n\n**Setup:**\n```bash\n# Install and start Ollama (for local models)\nollama serve\n\n# Pull your preferred model\nollama pull llama3:8b\n\n# Configure AtlasServer AI\natlasserver ai setup --model llama3:8b\n\n# Analyze a project\natlasserver ai suggest ~/path/to/your/project\n\n# Make a general query about your system or projects\natlasai --query \"What projects do I have here and how should I deploy them?\"\n```\n\n### \ud83d\udd27 Development Installation\n\nIf you want to contribute to AtlasServer or install from source:\n\n```bash\n# Clone the repository\ngit clone https://github.com/AtlasServer-Core/AtlasServer-Core.git\ncd AtlasServer-Core\n\n# Install in development mode\npip install -e .\n```\n\n---\n\n\n### \ud83d\udce2 Join the Beta\n\nWe're running a **3\u20134 week closed beta** to refine usability, tunnel stability, and overall workflow.\n\n\ud83d\udc49 **Join our Discord** for beta access, discussions, and direct feedback:\n\n[](https://discord.gg/QedUbbQpK9)\n\n---\n\n\n### \ud83d\udcc4 License\n\nThis project is licensed under the **Apache License 2.0**. \n[](https://www.apache.org/licenses/LICENSE-2.0)\n\nYou may obtain a copy of the License at: \n`http://www.apache.org/licenses/LICENSE-2.0`\n\nUnless required by applicable law or agreed to in writing, software \ndistributed under the License is distributed on an **\"AS IS\" BASIS**, \nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. \n\nSee the [full license text](LICENSE) for details. \n\n## Star History\n\n[](https://www.star-history.com/#AtlasServer-Core/AtlasServer-Core&Date)\n\n### \ud83d\udc96 THANK YOU FOR YOUR STARS!!\n\n\n## \ud83d\udc96 Support the Project\n\nIf you find AtlasServer-Core useful, please consider buying me a coffee:\n\n[](https://buymeacoffee.com/atlasserver)\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Fast Deploy Manager for demo apps made with Flask, FastAPI, and Django",
"version": "0.3.5",
"project_urls": {
"Homepage": "https://github.com/AtlasServer-Core/AtlasServer-Core",
"Issues": "https://github.com/AtlasServer-Core/AtlasServer-Core/issues"
},
"split_keywords": [
"flask",
" fastapi",
" django",
" deploy",
" demo"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e773053c06b5165b5592ce2beff9502121f6e57e5e60d6eed47d82113a4742d1",
"md5": "489077a7a13f083d2ce08113f6e3594c",
"sha256": "3ddc99f422f875f7857429876131bea164608edfa36f1baacb099e4d37f86c11"
},
"downloads": -1,
"filename": "atlasserver-0.3.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "489077a7a13f083d2ce08113f6e3594c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 67947,
"upload_time": "2025-07-20T22:54:03",
"upload_time_iso_8601": "2025-07-20T22:54:03.118485Z",
"url": "https://files.pythonhosted.org/packages/e7/73/053c06b5165b5592ce2beff9502121f6e57e5e60d6eed47d82113a4742d1/atlasserver-0.3.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a2e5c06b1d89e371f3edbb1986ca07f769cac91758342b2a951645a082b73491",
"md5": "2a1862524e75c343b5763f1a1ae2a7f6",
"sha256": "865c129a26f67dd63d48cd915c2b91ca33c77a156f5e86280a46fdda56637b49"
},
"downloads": -1,
"filename": "atlasserver-0.3.5.tar.gz",
"has_sig": false,
"md5_digest": "2a1862524e75c343b5763f1a1ae2a7f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 58908,
"upload_time": "2025-07-20T22:54:04",
"upload_time_iso_8601": "2025-07-20T22:54:04.580303Z",
"url": "https://files.pythonhosted.org/packages/a2/e5/c06b1d89e371f3edbb1986ca07f769cac91758342b2a951645a082b73491/atlasserver-0.3.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-20 22:54:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AtlasServer-Core",
"github_project": "AtlasServer-Core",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "Flask",
"specs": []
},
{
"name": "Werkzeug",
"specs": []
},
{
"name": "Jinja2",
"specs": []
},
{
"name": "bcrypt",
"specs": [
[
"==",
"4.0.1"
]
]
},
{
"name": "passlib",
"specs": []
},
{
"name": "fastapi",
"specs": []
},
{
"name": "uvicorn",
"specs": []
},
{
"name": "waitress",
"specs": []
},
{
"name": "sqlalchemy",
"specs": []
},
{
"name": "psutil",
"specs": []
},
{
"name": "pydantic",
"specs": []
},
{
"name": "python-multipart",
"specs": []
},
{
"name": "pyngrok",
"specs": []
},
{
"name": "aiofiles",
"specs": []
},
{
"name": "gunicorn",
"specs": []
},
{
"name": "platformdirs",
"specs": []
}
],
"lcname": "atlasserver"
}