Aetherin ecosystem overview
This directory holds the strategic documentation for the Aetherin AI ecosystem and the specification of the Aetherin Agent Studio product.
Files
| File | Purpose |
|---|---|
| `../README.md` | High-level repo overview, mission, and product vision. |
| `../AGENTS.md` (../AGENTS.md) | Agent guidance for working in this repository. |
| `project-overview.md` (project-overview.md) | This file — ecosystem framing, canonical surface and repo inventory. |
| `product-blueprint.md` (product-blueprint.md) | Buildable spec for Agent Studio: definition vs aetherin-agent, scope, surfaces, data model, contract mapping. |
| `roadmap.md` (roadmap.md) | Milestone plan (M0–M4) with deliverables, exit criteria, and dependencies. |
Purpose
The goal is to connect the existing projects into one coherent platform story and define the orchestration layer that makes them work as a single AI-native product machine. This repo is the planning anchor; it contains no runtime code.
Two products, two repos
The Aetherin stack contains two similarly named but distinct products. Do not conflate them:
- Aetherin Agent (
AetherinLLM/aetherin-agent) — a *shipped* product: the
revenue-focused chat agent at agent.aetherin.app with server-side tool calling. Registered in the surface registry as Agent (status: live).
- Aetherin Agent Studio (this repo,
AetherinLLM/aetherin-agent-studio) — a
*specification-stage* build-orchestration product that turns a brief, a repo, and uploaded assets into a planned, scaffolded, validated, and release-ready project via coordinated agents. It has no runtime surface yet and is not in the surface registry.
The full comparison and the Studio's scope are defined in `product-blueprint.md` (product-blueprint.md).
Canonical surface inventory
This table mirrors the canonical platform map in aetherin-portal/account/js/registry.js, which is kept in sync with aetherin-stack/docs/stack-plan/docs/03-status.md. Surface names below are the registry's name values and are the only names to use when referring to a surface.
| Surface | Registry id | Host | Registry status | Role in the ecosystem |
|---|---|---|---|---|
| Portal | portal | aetherin.app | live | Org front door, site atlas, setup finder. |
| Account center | account | aetherin.app/account | preview | User system, dashboard, setup generator, keys, usage/billing, org-admin self-service. |
| Agent | agent | agent.aetherin.app | live | Revenue-focused chat agent with server-side tool calling (aetherin-agent). |
| Streamproof | streamproof | streamproof.aetherin.app | preview | Predictable, budget-controlled model calls. |
| Admin console | admin | admin.aetherin.app | preview | Platform operations: cross-org support, infrastructure, billing health. |
| Gateway | gateway | gateway.aetherin.app | planned | Self-hosted, OpenAI-compatible model gateway with routing and accounting. |
| MCP hub | mcp | mcp.aetherin.app | planned | Model Context Protocol hub exposing Aetherin tools to any agent. |
| Plugins | plugins | plugins.aetherin.app | planned | TUI / IDE / web / mobile clients for the gateway. |
| Preset studio | presets | aetherin.app/presets | planned | Publish and apply named setups across surfaces. |
| Design system | design | aetherin.app/design | live | Living design system across every world. |
Agent Studio proposes one additional surface (not yet registered). See `product-blueprint.md` (product-blueprint.md#4-surfaces-and-pages) for its pages and the registration requirement.
Canonical repo map
Repo boundaries follow aetherin-stack/docs/stack-plan/docs/03-status.md ("role → path"). This repo is the planning layer only.
| Role | Repo / path |
|---|---|
| Studio planning (this repo) | AetherinLLM/aetherin-agent-studio |
| Portal (apex + account + design) | AetherinLLM/aetherin-ecosystem/aetherin-portal |
| Agent product | AetherinLLM/aetherin-agent |
| Streamproof | AetherinLLM/ai-gateway/streamproof |
| Gateway runtime + console | aetherin-stack/core |
| Legacy relay (gateway-base / new-api) | AetherinLLM/ai-gateway/gateway-base |
| MCP / Nexus | merlin-tribukait/ai-tools/ai-bible/nexus |
| Experiments | merlin-tribukait/ai-tools/* |
Older repositories (Gatherin, aetherin-stack-plan, aetherin-frontend, aetherin-common, aetherin-middleware, interference, model-test) are archived/legacy and remain useful as historical architecture context only. They are not part of the current operating core.
Strategic synthesis
The present-day organization is a layered system rather than a flat set of experiments:
- front door and brand layer: Portal
- model access and runtime control: Streamproof, Gateway
- tool exposure: MCP hub, Plugins
- identity, billing, and self-service: Account center, Preset studio
- product chat: Agent
- platform operations: Admin console
- design: Design system
- product planning and orchestration: Aetherin Agent Studio (this repo)
That is the foundation for the one-click build platform described in `product-blueprint.md` (product-blueprint.md).