Skip to content

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 startedGlossaryArchitecture overview
Backend engineer Kernel, Task graph, Services
Operator Operations, Deployment, runbooks
Security reviewer Security, PRD §18

Reading order

  1. This page → Glossary if terms are unfamiliar.
  2. Architecture overview — layers and goal→task flow.
  3. Services — all sixteen services.
  4. Reference — contracts, schema, Redis, APIs.
  5. 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.

    Getting started

  • Glossary


    Terms and acronyms.

    Glossary

  • Security


    mTLS, JWT, sandbox, Vault, approvals.

    Security

  • Architecture


    Kernel, actors, scheduler, memory, LLM routing.

    Architecture

  • Reference


    gRPC, schema, Redis, APIs, metrics, SLAs.

    Reference

  • Operations


    Runbooks and incident flow.

    Operations

  • Deployment


    K8s, local, macOS, GCP.

    Deployment