Skip to content

Latest commit

 

History

History
177 lines (128 loc) · 8.16 KB

README.md

File metadata and controls

177 lines (128 loc) · 8.16 KB

Aegra banner

Aegra

Self-hosted LangSmith Deployments alternative. Your infrastructure, your rules.

PyPI API PyPI CLI CI Codecov

GitHub stars License Discord Sponsor

Aegra is a drop-in replacement for LangSmith Deployments. Use the same LangGraph SDK, same APIs, but run it on your own infrastructure with PostgreSQL persistence.

Works with: Agent Chat UI | LangGraph Studio | AG-UI / CopilotKit

🚀 Quick Start

Using the CLI (Recommended)

Prerequisites: Python 3.12+, Docker (for PostgreSQL)

pip install aegra-cli

# Initialize a new 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 to .env
uv sync                  # Install dependencies
uv run aegra dev         # Start PostgreSQL + dev server

Note: Always install aegra-cli directly — not the aegra meta-package. The aegra package on PyPI is a convenience wrapper that does not support version pinning.

From Source

git clone https://github.com/ibbybuilds/aegra.git
cd aegra
cp .env.example .env
# Add your OPENAI_API_KEY to .env

docker compose up

Open http://localhost:2026/docs to explore the API.

Your existing LangGraph code works without changes:

from langgraph_sdk import get_client

client = get_client(url="http://localhost:2026")

assistant = await client.assistants.create(graph_id="agent")
thread = await client.threads.create()

async for chunk in client.runs.stream(
    thread_id=thread["thread_id"],
    assistant_id=assistant["assistant_id"],
    input={"messages": [{"type": "human", "content": "Hello!"}]},
):
    print(chunk)

🔥 Why Aegra?

Based on LangChain pricing as of February 2026. An enterprise tier with self-hosting is also available at custom pricing.

LangSmith Deployments Aegra
Deploy agents Local dev only (Free), paid cloud (Plus) Free, unlimited
Custom auth Not available (Free), available (Plus) Python handlers (JWT/OAuth/Firebase)
Self-hosted Enterprise only (license key required) Always (Apache 2.0)
Own database Managed only (Free/Plus), bring your own (Enterprise) Bring your own Postgres
Tracing LangSmith only Any OTLP backend (Langfuse, Phoenix, etc.)
Data residency LangChain cloud (Free/Plus), your infrastructure (Enterprise) Your infrastructure
SDK LangGraph SDK Same LangGraph SDK

✨ Features

🛠️ CLI Commands

aegra init              # Interactive — asks for location, template, and name
aegra init ./my-agent   # Create at path (still prompts for template)

aegra dev               # Start development server (hot reload + auto PostgreSQL)
aegra serve             # Start production server (no reload)
aegra up                # Build and start all Docker services
aegra down              # Stop Docker services

aegra version           # Show version info

📚 Documentation

docs.aegra.dev — Full documentation with guides, API reference, and configuration.

Topic Description
Quickstart Get a running server in under 5 minutes
Configuration aegra.json format and all options
Authentication JWT, OAuth, Firebase, or custom auth handlers
Streaming 8 SSE stream modes with reconnection
Store Key-value and semantic search storage
Observability Fan-out tracing to Langfuse, Phoenix, or any OTLP backend
Deployment Docker, PaaS, and Kubernetes deployment
Migration Migrate from LangSmith Deployments

💬 Community & Support

🏗️ Built With

🤝 Contributing

We welcome contributions! See Contributing guide and check out good first issues.

💖 Support the Project

The best contribution is code, PRs, and bug reports - that's what makes open source thrive.

For those who want to support Aegra financially, whether you're using it in production or just believe in what we're building, you can become a sponsor. Sponsorships help keep development active and the project healthy.

📄 License

Apache 2.0 - see LICENSE.

⭐ Star us if Aegra helps you escape vendor lock-in ⭐

Star History Chart