Metadata-Version: 2.4
Name: etherion
Version: 0.1.1
Summary: Self-hosted AI orchestration platform — agentic runtime you own end-to-end
Project-URL: Homepage, https://github.com/Saturn99X/Etherion
Project-URL: Repository, https://github.com/Saturn99X/Etherion
Project-URL: Bug Tracker, https://github.com/Saturn99X/Etherion/issues
License: MIT
Keywords: agents,ai,celery,langchain,llm,orchestration,pgvector,self-hosted
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.11
Requires-Dist: alembic>=1.13
Requires-Dist: asyncpg>=0.29
Requires-Dist: authlib>=1.3
Requires-Dist: celery>=5.3
Requires-Dist: cryptography>=42.0
Requires-Dist: email-validator>=2.0
Requires-Dist: fastapi>=0.111
Requires-Dist: google-cloud-secret-manager>=2.0
Requires-Dist: httpx>=0.27
Requires-Dist: langchain-core>=0.2
Requires-Dist: langchain>=0.2
Requires-Dist: minio>=7.2
Requires-Dist: pgvector>=0.3
Requires-Dist: psycopg2-binary>=2.9
Requires-Dist: python-dotenv>=1.0
Requires-Dist: python-jose[cryptography]>=3.3
Requires-Dist: redis>=5.0
Requires-Dist: rich>=13
Requires-Dist: sqlalchemy[asyncio]>=2.0
Requires-Dist: sqlmodel>=0.0.19
Requires-Dist: strawberry-graphql[fastapi]>=0.235
Requires-Dist: typer[all]>=0.12
Requires-Dist: uvicorn[standard]>=0.30
Provides-Extra: dev
Requires-Dist: httpx; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-asyncio; extra == 'dev'
Provides-Extra: full
Requires-Dist: hvac>=2.0; extra == 'full'
Requires-Dist: langchain-anthropic>=0.1; extra == 'full'
Requires-Dist: langchain-google-genai>=1.0; extra == 'full'
Requires-Dist: langchain-openai>=0.1; extra == 'full'
Description-Content-Type: text/markdown

# Etherion

**Etherion** is a self-hosted AI orchestration platform — a complete agentic runtime you own end-to-end.

Install it, configure a `.env`, run one command, and you have a multi-tenant AI backend with parallel agent dispatch, a knowledge base, OAuth integrations, and a full-featured TUI — running on your own hardware.

## Quick Start

```bash
pip install etherion

# Scaffold a .env in the current directory
etherion init

# Edit .env with your API keys, then:

# Docker mode (recommended for first-time setup)
etherion bootstrap --mode docker

# Run database migrations
etherion migrate

# Create your first tenant + user
etherion tenant create --email you@example.com --password yourpass

# Check everything is green
etherion status

# Start the API server
etherion serve
```

## Modes

| Mode | Command | Description |
|------|---------|-------------|
| **Docker** | `etherion bootstrap --mode docker` | Spins up Postgres, Redis, MinIO via Docker Compose. Zero config. |
| **Nix** | `etherion bootstrap --mode nix` | Declarative bare-metal setup via NixOS modules. Fully reproducible. |

## Features

- **Parallel agent dispatch** — run multiple AI agents concurrently across a job queue
- **Knowledge base** — pgvector-powered semantic search with multi-tenant row-level security
- **OAuth integrations** — GitHub, Google, Slack, Notion, Jira, HubSpot, Linear, Shopify
- **MinIO object storage** — store artifacts, documents, and media on your own hardware
- **HashiCorp Vault** — secrets injected into RAM, never on disk
- **Bubble Tea TUI** — full onboarding wizard, OAuth management, live monitoring
- **GraphQL API** — subscriptions, multi-tenant, CSRF-protected

## CLI Commands

```
etherion init          Scaffold .env and config files
etherion bootstrap     Start infrastructure (Docker or Nix mode)
etherion migrate       Run Alembic database migrations
etherion serve         Start the API server
etherion worker        Start Celery worker (start / beat)
etherion tenant        Manage tenants and users
etherion status        Health check (Postgres, Redis, MinIO, API, Worker)
```

## Requirements

- Python 3.11+
- Docker (for Docker mode) or NixOS (for Nix mode)
- PostgreSQL 16 + pgvector (managed automatically in both modes)

## License

MIT
