Astra¶
Astra is an operating system for autonomous agents: a microkernel (actors, task graph, scheduler, messaging, state), sixteen microservices, sandboxed tools, layered memory, and LLM routing as infrastructure — not a single-model chat wrapper or a UI product.
Executive summary: Persistent agents submit goals; the planner materialises DAGs of tasks; the scheduler dispatches work via Redis Streams; workers run tasks inside sandboxes; Postgres is the source of truth and Redis/Memcached enforce the ≤10ms read path. Everything external talks through JWT; services talk over mTLS; dangerous work passes policy and approval gates.
flowchart LR
U[Client] --> GW[API gateway]
GW --> GS[goal-service]
GS --> PL[planner]
PL --> TS[task-service]
TS --> SCH[scheduler]
SCH --> R[(Redis)]
R --> EW[execution-worker]
EW --> TR[tool-runtime]
Goals¶
| Goal | Target |
|---|---|
| Scale | Millions of agents, 100M+ tasks/day (PRD §1). |
| Latency | No hot-path API read over 10ms p99; scheduling median ≤50ms, P95 ≤500ms (PRD §25). |
| Safety | Sandboxed tools, RBAC, approvals, secrets in Vault, mTLS everywhere between services. |
| Operability | Metrics, traces, runbooks, rolling upgrades with backward-compatible schema. |
Non-goals¶
- Not building foundation models — Astra integrates providers.
- Not replacing every data platform — it composes Postgres, Redis, object storage, etc.
- Not embedding app logic in the kernel — strict kernel/SDK/app boundary (PRD §2).
- Not only a chat product — chat is one surface on the gateway; core is the task graph and actor runtime.
Who should read what¶
| Role | Start with |
|---|---|
| New contributor | Getting started → Glossary → Architecture overview |
| Backend engineer | Kernel, Task graph, Services |
| Operator | Operations, Deployment, runbooks |
| Security reviewer | Security, PRD §18 |
Reading order¶
- This page → Glossary if terms are unfamiliar.
- Architecture overview — layers and goal→task flow.
- Services — all sixteen services.
- Reference — contracts, schema, Redis, APIs.
- Operations when you’re on call.
At a glance¶
| Dimension | Value |
|---|---|
| Language | Go (primary), Python tooling |
| Kernel | Microkernel + actor runtime |
| Tasks | Distributed DAG, transactional state |
| Bus | Redis Streams + consumer groups |
| Source of truth | Postgres (+ pgvector) |
| Hot cache | Redis, Memcached |
| Sandboxing | WASM / Docker / Firecracker |
| Services | 16 canonical microservices |
| Spec | PRD in the Astra repo |
Maturity
Astra is under active implementation. Wiki pages track the PRD; some features are phased per PRD §26–27. When in doubt, read the PRD section cited on each page.
Sections¶
-
Getting Started
Repo layout, prerequisites, local paths.
-
Glossary
Terms and acronyms.
-
Security
mTLS, JWT, sandbox, Vault, approvals.
-
Architecture
Kernel, actors, scheduler, memory, LLM routing.
-
Reference
gRPC, schema, Redis, APIs, metrics, SLAs.
-
Operations
Runbooks and incident flow.
-
Deployment
K8s, local, macOS, GCP.