aegra-cli
Aegra CLI - Command-line interface for managing self-hosted agent deployments.
Aegra is an open-source, self-hosted alternative to LangSmith Deployments. Use this CLI to initialize projects, run development servers, and manage Docker services.
Installation
From PyPI
pip install aegra-cli
From Source
# Clone the repository
git clone https://github.com/aegra/aegra.git
cd aegra
# Install all workspace packages
uv sync --all-packages
Quick Start
# Initialize a new Aegra project (prompts for location, template, and name)
aegra init
# Follow the printed next steps
cd <your-project>
cp .env.example .env # Add your OPENAI_API_KEY
uv sync # Install dependencies
uv run aegra dev # Start PostgreSQL + dev server
Commands
aegra version
Show version information for aegra-cli and aegra-api.
aegra version
Output displays a table with versions for both packages.
aegra init
Initialize a new Aegra project with configuration files and directory structure.
aegra init [PATH] [OPTIONS]
Arguments:
| Argument | Default | Description |
|---|---|---|
PATH |
. |
Project directory to initialize |
Options:
| Option | Description |
|---|---|
-t, --template INT |
Template number (1 = "New Aegra Project", 2 = "ReAct Agent") |
-n, --name STR |
Project name |
--force |
Overwrite existing files if they exist |
Templates:
| # | Name | Description |
|---|---|---|
| 1 | New Aegra Project | Simple chatbot with basic graph structure |
| 2 | ReAct Agent | Tool-calling agent with a tools module |
Examples:
# Initialize in current directory
aegra init
# Initialize in a specific directory
aegra init my-project
# Initialize with a specific template and name
aegra init my-project --template 2 --name "My ReAct Agent"
# Initialize in current directory, overwriting existing files
aegra init --force
Created Files:
aegra.json- Graph configurationpyproject.toml- Python project configuration.env.example- Environment variable template.gitignore- Git ignore rulesREADME.md- Project readmesrc/<slug>/__init__.py- Package init filesrc/<slug>/graph.py- Graph implementationsrc/<slug>/state.py- State schema definitionsrc/<slug>/prompts.py- Prompt templatessrc/<slug>/context.py- Context configurationsrc/<slug>/utils.py- Utility functionssrc/<slug>/tools.py- Tool definitions (ReAct template only)docker-compose.yml- Docker Compose for PostgreSQL and API servicesDockerfile- Container build
aegra dev
Run the development server with hot reload.
aegra dev [OPTIONS]
Options:
| Option | Default | Description |
|---|---|---|
--host HOST |
127.0.0.1 |
Host to bind the server to |
--port PORT |
2026 |
Port to bind the server to |
--app APP |
aegra_api.main:app |
Application import path |
-c, --config PATH |
Path to aegra.json config file | |
-e, --env-file PATH |
Path to .env file | |
-f, --file PATH |
Path to docker-compose.yml file | |
--no-db-check |
Skip the automatic database check |
Examples:
# Start with defaults (localhost:2026)
aegra dev
# Start on all interfaces, port 3000
aegra dev --host 0.0.0.0 --port 3000
# Start with a custom app
aegra dev --app myapp.main:app
# Start with a specific config and env file
aegra dev --config ./aegra.json --env-file ./.env
# Start without automatic database check
aegra dev --no-db-check
The server automatically restarts when code changes are detected.
aegra serve
Run the production server (no hot reload).
aegra serve [OPTIONS]
Options:
| Option | Default | Description |
|---|---|---|
--host HOST |
0.0.0.0 |
Host to bind the server to |
--port PORT |
2026 |
Port to bind the server to |
--app APP |
aegra_api.main:app |
Application import path |
-c, --config PATH |
Path to aegra.json config file |
Examples:
# Start with defaults (0.0.0.0:2026)
aegra serve
# Start with a custom config
aegra serve --config ./aegra.json
aegra up
Start services with Docker Compose.
aegra up [SERVICES...] [OPTIONS]
Arguments:
| Argument | Description |
|---|---|
SERVICES |
Optional list of specific services to start |
Options:
| Option | Default | Description |
|---|---|---|
-f, --file FILE |
Path to docker-compose.yml file | |
--build / --no-build |
--build |
Build images before starting containers (on by default) |
Examples:
# Start all services (builds by default)
aegra up
# Start only postgres
aegra up postgres
# Start without building
aegra up --no-build
# Start with a custom compose file
aegra up -f ./docker-compose.yml
aegra down
Stop services with Docker Compose.
aegra down [OPTIONS]
Options:
| Option | Description |
|---|---|
-f, --file FILE |
Path to docker-compose.yml file |
-v, --volumes |
Remove named volumes declared in the compose file |
Examples:
# Stop all services
aegra down
# Stop and remove volumes (WARNING: data will be lost)
aegra down -v
# Stop with a custom compose file
aegra down -f ./docker-compose.yml
Environment Variables
The CLI respects the following environment variables (typically set via .env file):
# Database
POSTGRES_USER=aegra
POSTGRES_PASSWORD=aegra_secret
POSTGRES_HOST=localhost
POSTGRES_DB=aegra
# Authentication
AUTH_TYPE=noop # Options: noop, custom
# Server (for aegra dev)
HOST=0.0.0.0
PORT=2026
# Configuration
AEGRA_CONFIG=aegra.json
Requirements
- Python 3.12+
- Docker (for
aegra upandaegra downcommands) - PostgreSQL (or use Docker)
Related Packages
- aegra-api: Core API package providing the Agent Protocol server
- aegra: Meta-package that installs both aegra-cli and aegra-api
Metadata
Release files for aegra-cli 0.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aegra_cli-0.11.0.tar.gz | 40.6 kB | Without provenance | Details for aegra_cli-0.11.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aegra_cli-0.11.0-py3-none-any.whl | Python 3 | none | any | Details for aegra_cli-0.11.0-py3-none-any.whl |
Total release size: 75.4 kB
Release files / aegra_cli-0.11.0.tar.gz
| Download URL | aegra_cli-0.11.0.tar.gz |
|---|---|
| Size | 40.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c011755b8d19e13cf8721c1df80257236825c8d1303df95bea9b9608e2074bf
|
|
BLAKE2b-256 checksum How to use checksums |
72b29d18d336a6a8c8f18af0eb9ea146d473fbb9091de46b5480d9c26b562f92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / aegra_cli-0.11.0-py3-none-any.whl
| Download URL | aegra_cli-0.11.0-py3-none-any.whl |
|---|---|
| Size | 34.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dadecfde4d41a7b65be949cba84e6a9a4ac27693ef0b037b52798040aeb33a29
|
|
BLAKE2b-256 checksum How to use checksums |
da24600a5dde32a8d1f728d51c25ce433c66e64c20ce1cf7b021b98e9946e381
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for aegra-cli 0.11.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.