How bhangun/andalus works
Andalus Runtime executes autonomous agents and workflows. The principal workflow begins with a CLI or REST invocation, passes into agent execution and orchestration, and produces an execution result; the README also documents programmatic execution and standalone runners. Runtime capabilities include memory/context, guardrails, human approval, knowledge and graph operations, sandboxing, and operational visibility. The source excerpts confirm selected execution, memory retrieval, HITL query/notification, and operator-service behavior. Several branches are documented but their wiring was not sampled, so those links are documented at the README level rather than inferred from module names.
Main entry points: AgentExecutionService.java Agent execution · DefaultExecutionEngine.java Execution engine · HumanTaskService.java Human tasks · AndalusGollekCli.java CLI
Components 24
Application interfaces
Execution and orchestration
- Agent execution
runtime/andalus-runtime-core/src/main/java/tech/kayys/andalus/execution/AgentExecutionService.java - Execution engine
runtime/andalus-runtime-core/src/main/java/tech/kayys/andalus/execution/DefaultExecutionEngine.java - Coordination engine
runtime/andalus-runtime-core/src/main/java/tech/kayys/andalus/coordination/CoordinationExecutionEngine.java - Workflow backend
runtime/andalus-workflow-runtime/src/main/java/tech/kayys/andalus/agent/integration/gamelan/AgentGamelanService.java
Governance and operations
- Guardrails
runtime/andalus-guardrails-runtime/src/main/java/tech/kayys/andalus/guardrails/policy/PolicyBasedGuardrailsEngine.java - Human tasks
runtime/andalus-hitl-runtime/src/main/java/tech/kayys/andalus/hitl/service/HumanTaskService.java - Task queries
runtime/andalus-hitl-runtime/src/main/java/tech/kayys/andalus/hitl/repository/HumanTaskQueryService.java - Task notifications
runtime/andalus-hitl-runtime/src/main/java/tech/kayys/andalus/hitl/service/NotificationService.java - Sandbox runtime
runtime/andalus-sandbox/src/main/java/tech/kayys/andalus/operator/runtime/sandbox/DefaultSandboxOperatorService.java - Operations and diagnostics
modules/andalus-hermes/src/main/java/tech/kayys/andalus/hermes/HermesOperationalService.java
Memory and knowledge
- Memory service
runtime/andalus-agent-runtime/src/main/java/tech/kayys/andalus/agent/core/memory/AgentMemoryService.java - Context engineering
runtime/andalus-memory-runtime/src/main/java/tech/kayys/andalus/memory/service/ContextEngineeringService.java - Embedding provider
runtime/andalus-memory-runtime/src/main/java/tech/kayys/andalus/memory/spi/EmbeddingService.java - Knowledge runtime
runtime/andalus-knowledge-runtime/src/main/java/tech/kayys/andalus/knowledge/DefaultKnowledgeMutationService.java - Graph runtime
runtime/andalus-graph-runtime/src/main/java/tech/kayys/andalus/graph/runtime/GraphQueryExecutor.java - RAG pipeline
runtime/andalus-rag-runtime/src/main/java/tech/kayys/andalus/rag/runtime/pipeline/DefaultRagPipeline.java
Backends and tools
- Gamelan adapter
runtime/andalus-backend-gamelan/src/main/java/tech/kayys/andalus/agent/backend/gamelan/GamelanCoordinationExecutionEngine.java - MCP tool integration
modules/tool/andalus-tool-mcp/src/main/java/tech/kayys/andalus/tool/mcp/McpServerActionPreviewService.java
Other components
- Agent user
- Inference provider
- Execution result
Connections 22
- Agent user → CLI: invokes
README.md - Agent user → REST API: invokes
README.md - CLI → Agent execution: starts execution
- REST API → Agent execution: starts execution
- Agent execution → Execution engine: runs pipeline
README.md - Execution engine → Execution result: returns result
README.md - Execution engine → Workflow backend: executes workflow
runtime/andalus-runtime-core/src/main/java/tech/kayys/andalus/execution/DefaultExecutionEngine.java - Execution engine → MCP tool integration: dispatches tools
- Coordination engine → Gamelan adapter: uses backend
README.md - Agent execution → Memory service: uses memory
README.md - Context engineering → Embedding provider: requests vectors
runtime/andalus-memory-runtime/src/main/java/tech/kayys/andalus/memory/service/ContextEngineeringService.java - Agent execution → Guardrails: applies policies
README.md - Agent execution → Human tasks: requests approval
README.md - Human tasks → Task queries: queries tasks
- Human tasks → Task notifications: sends notices
README.md - Agent user → gRPC API: invokes
- Knowledge runtime → Graph runtime: uses graph store
README.md - Agent execution → RAG pipeline: uses retrieval
- Agent user → Sandbox runtime: operates runtime
- Agent user → Operations and diagnostics: checks operations
- Agent execution → Inference provider: requests inference
README.md - Agent execution → Coordination engine: coordinates agents
README.md