How bhangun/andalus-framework works
Andalus is a modular Java framework for building autonomous agents and workflows, intended as reusable contracts, adapters, and services beneath a separate runtime. A typical user request enters agent orchestration, invokes an agent and model or tools, and can be coordinated as a workflow; communication adapters support local and remote agents. Knowledge, security, governance, and observability are supporting capability branches. The README documents these capabilities, but sampled source does not establish most runtime wiring, so those connections are shown as unverified.
Main entry points: AgentOrchestrator.java Agent Orchestrator · AgentCommunicator.java Communication API · TaskController.java Communication Core · InferenceService.java Inference Routing
Components 23
Agent Execution
- Agent Contracts
framework/andalus-agent/src/main/java/tech/kayys/andalus/agent/Agent.java - Agent Orchestrator
framework/andalus-agent/src/main/java/tech/kayys/andalus/agent/orchestration/AgentOrchestrator.java - Execution Engine
framework/andalus-engine/src/main/java/tech/kayys/andalus/execution/ExecutionEngine.java - Workflow Engine
framework/andalus-workflow/src/main/java/tech/kayys/andalus/workflow/WorkflowEngine.java - Inference Routing
framework/andalus-provider/src/main/java/tech/kayys/andalus/inference/InferenceService.java - Model Providers
framework/andalus-provider/src/main/java/tech/kayys/andalus/provider/Provider.java
Communication
- Communication API
framework/andalus-communication-api/src/main/java/tech/kayys/andalus/communication/api/AgentCommunicator.java - Communication Core
framework/andalus-communication-core/src/main/java/tech/kayys/andalus/communication/core/task/TaskController.java - A2A Adapter
framework/andalus-a2a/src/main/java/tech/kayys/andalus/a2a/adapter/A2AAgentAdapter.java - ANP Discovery
framework/andalus-anp/src/main/java/tech/kayys/andalus/anp/discovery/AnpAgentDiscovery.java - Agent Network
framework/andalus-agent-network-core/src/main/java/tech/kayys/andalus/network/core/DefaultAgentNetwork.java
Tools & Knowledge
- Tool Invocation
framework/andalus-tool/src/main/java/tech/kayys/andalus/tool/ToolInvocation.java - Plugin Lifecycle
framework/andalus-plugin/src/main/java/tech/kayys/andalus/plugin/DefaultPluginLifecycleManager.java - Knowledge Services
framework/andalus-knowledge/src/main/java/tech/kayys/andalus/knowledge/graph/KnowledgeGraphProjectionService.java - RAG Pipeline
framework/andalus-rag/src/main/java/tech/kayys/andalus/rag/spi/RagPipeline.java - Memory Manager
framework/andalus-memory/src/main/java/tech/kayys/andalus/memory/manager/DefaultMemoryManager.java - Embedding Service
framework/andalus-embedding/src/main/java/tech/kayys/andalus/embedding/EmbeddingService.java
Security & Governance
- Authorization
framework/andalus-security-core/src/main/java/tech/kayys/andalus/security/policy/PolicyAuthorizationService.java - Tool Authorization
framework/andalus-runtime-spi/src/main/java/tech/kayys/andalus/execution/governance/DefaultToolAuthorizationService.java - Guardrails
framework/andalus-guardrails/src/main/java/tech/kayys/andalus/guardrails/GuardrailsService.java
Operations
- Audit Services
framework/andalus-audit/src/main/java/tech/kayys/andalus/audit/AuditService.java - Tracing
framework/andalus-observability/src/main/java/tech/kayys/andalus/tracing/TracingService.java
Other components
- Agent User
Connections 22
- Agent User → Agent Orchestrator: submits request
- Agent Orchestrator → Agent Contracts: invokes agent
- Agent Orchestrator → Execution Engine: coordinates execution
- Agent Orchestrator → Workflow Engine: runs workflows
- Agent Orchestrator → Inference Routing: requests inference
- Inference Routing → Model Providers: routes completion
framework/andalus-provider/src/main/java/tech/kayys/andalus/inference/InferenceService.java - Agent Orchestrator → Communication API: communicates agents
- Communication Core → Communication API: implements contracts
- Communication API → A2A Adapter: supports A2A
- Communication API → ANP Discovery: supports ANP
- Communication Core → Agent Network: routes network tasks
- Agent Orchestrator → Tool Invocation: uses tools
- Plugin Lifecycle → Tool Invocation: extends tool systems
- Agent Orchestrator → Knowledge Services: uses knowledge
- Agent Orchestrator → RAG Pipeline: retrieves context
- Agent Orchestrator → Memory Manager: uses memory
- RAG Pipeline → Embedding Service: embeds content
- Agent Orchestrator → Authorization: checks authorization
- Agent Orchestrator → Tool Authorization: authorizes tools
- Agent Orchestrator → Guardrails: applies safeguards
- Agent Orchestrator → Audit Services: records activity
- Agent Orchestrator → Tracing: emits telemetry