Prerequisites
- Python 3.12 or 3.13 (3.14 not yet supported)
- Git for cloning the repository
- Node 18+ and Rust (optional, for desktop app)
Installation
Configure environment
Copy the example environment file:Add your API keys to
backend/.env (optional - you can add them later in Settings).Start Asta
Use the control script to start the backend:The script will automatically detect Python 3.12 or 3.13, create a virtual environment, install dependencies, and start the backend on port 8010.
Access the API
Open your browser to:
- API Documentation: http://localhost:8010/docs
- Health Check: http://localhost:8010/health
Next Steps
Desktop App
Install the cross-platform desktop app
Configure Providers
Set up Claude, OpenAI, or other AI providers
Telegram Bot
Connect your Telegram bot
Create Skills
Build custom workspace skills
Control Script Commands
Theasta.sh script provides several commands:
| Command | Description |
|---|---|
./asta.sh start | Start the backend |
./asta.sh stop | Stop all services |
./asta.sh restart | Restart the backend |
./asta.sh status | Show service status |
./asta.sh doc | Run diagnostics |
./asta.sh doc --fix | Auto-fix common issues |
./asta.sh install | Add asta to your PATH |
Troubleshooting
Python 3.14 not supported
Python 3.14 not supported
Asta requires Python 3.12 or 3.13. Python 3.14 is not yet compatible with pydantic and ChromaDB.Install Python 3.12:
Port 8010 already in use
Port 8010 already in use
The script automatically frees port 8010. If it persists, run:
Backend won't start
Backend won't start
Check the logs at
backend.log and run diagnostics:What’s Next?
- Full Installation Guide - Detailed setup for all platforms
- Architecture Overview - Understand how Asta works
- API Reference - Explore the REST API