etherion 0.1.0

Self-hosted AI orchestration platform — agentic runtime you own end-to-end

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

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 [e-mail] --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