How nabilkhan-01/astralis works
ASTRALIS is a modular personal AI assistant. Its documented request workflow runs from the CLI through memory retrieval and context assembly to the Brain and capability execution, returning a response while keeping the user in control. The graph also shows persistent memory, interchangeable AI providers, and the broader capability integrations. Edges are grounded in the README or shown source/index references; several capability and provider internals were not sampled, so their detailed runtime calls are not asserted.
Main entry points: request_pipeline.py Request pipeline · brain.py Brain · bootstrap.py Bootstrap · capability Capabilities
Components 25
Request and reasoning
- CLI
astralis/interfaces/cli.py - Request pipeline
astralis/pipeline/request_pipeline.py - Brain
astralis/brain/brain.py - Interpret and plan
astralis/brain/interpreter.py - Conversation state
astralis/brain/conversation.py - Response
astralis/brain/response.py
Context and memory
- Memory retrieval
astralis/memory/retriever.py - Relevance ranking
astralis/context/relevance.py - Request context
astralis/context/context.py - Memory manager
astralis/memory/manager.py - Entity store
astralis/memory/json_store.py - Domain memories
astralis/memory
Capabilities and integrations
- Capability manager
astralis/capability/manager.py - Capability registry
astralis/capability/registry.py - Capabilities
astralis/capability - Computer tools
astralis/tools - External APIs
astralis/api - Provider factory
astralis/providers/factory.py - AI providers
astralis/providers
Application runtime
- Bootstrap
astralis/bootstrap/bootstrap.py - Application
astralis/bootstrap/application.py - Configuration
astralis/core/config.py - Request monitoring
astralis/monitoring/monitor.py
Other components
- User
- Web and service APIs
Connections 25
- User → CLI: submits request
README.md - CLI → Request pipeline: forwards request
astralis/interfaces/cli.py - Request pipeline → Memory retrieval: retrieves memory
astralis/pipeline/request_pipeline.py - Memory retrieval → Memory manager: loads entities
astralis/memory/retriever.py - Memory manager → Entity store: reads and writes
astralis/memory/manager.py - Memory retrieval → Relevance ranking: ranks candidates
astralis/memory/retriever.py - Relevance ranking → Request context: builds context
astralis/context/relevance.py - Request pipeline → Brain: processes request
astralis/pipeline/request_pipeline.py - Request pipeline → Request monitoring: measures request
astralis/pipeline/request_pipeline.py - Brain → Interpret and plan: interprets and plans
astralis/brain/brain.py - Brain → Conversation state: records messages
astralis/brain/brain.py - Brain → Capability manager: executes plan
astralis/brain/brain.py - Capability manager → Capability registry: selects capability
astralis/capability/manager.py - Capability manager → Capabilities: executes capability
astralis/capability/manager.py - Brain → Request context: uses retrieved context
astralis/brain/brain.py - Request pipeline → Response: returns response
astralis/pipeline/request_pipeline.py - Bootstrap → Application: assembles components
astralis/bootstrap/bootstrap.py - Bootstrap → Capability registry: registers capabilities
astralis/bootstrap/bootstrap.py - Bootstrap → Provider factory: creates provider
astralis/bootstrap/bootstrap.py - Provider factory → AI providers: selects implementation
- Bootstrap → Configuration: loads configuration
astralis/bootstrap/bootstrap.py - Capabilities → Computer tools: uses computer tools
- Capabilities → External APIs: uses service clients
astralis/capability/search.py - External APIs → Web and service APIs: calls external services
- Capabilities → AI providers: uses language provider