ares

module
v0.2.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 13, 2026 License: Apache-2.0

README

           _____  ______  _____ 
     /\   |  __ \|  ____|/ ____|
    /  \  | |__) | |__  | (___  
   / /\ \ |  _  /|  __|  \___ \ 
  / ____ \| | \ \| |____ ____) |
 /_/    \_\_|  \_\______|_____/ 

ARES — Agent Runtime & Evolution System.

Build resilient, self-evolving AI agents in Go. Unified SDK, DAG workflow, chaos engineering, MCP support.

Runtime Evolution: ARES continuously evolves its DAG topology, scheduler, knowledge planner, and recovery strategies — all in production, without restarts. LLM is a participant in evolution, not the leader.

Quick Start

package main

import "github.com/Timwood0x10/ares/sdk"

func main() {
    rt := sdk.MustNew(sdk.WithOllama("llama3.2"))
    defer rt.Close()

    agent := rt.NewAgent("assistant")
    result, _ := agent.Run(ctx, "Say hello")
    println(result.Output)
}

Install the CLI:

go install github.com/Timwood0x10/ares/cmd/ares@latest
ares doctor
ares run -c ares.yaml "What is Go?"

Or run examples directly:

git clone https://github.com/Timwood0x10/ares
cd ares
make quickstart        # go run examples/quickstart
make examples          # build all 24 examples

Features

Feature Description
Unified SDK Single sdk.MustNew() API for LLM, tools, memory, evolution
Runtime Evolution Genome + Diff Engine + Coordinator evolve DAG, scheduler, planner, recovery in production
Strategy GA Population-based strategy optimization — NSGA-II multi-objective, steady-state, uniform/two-point/segment crossover, 6 mutation types
Evidence-Driven Every runtime event (flight, chaos, fitness) feeds into evolution decisions
DAG Workflow Dynamic graphs with conditional branching and recovery
Chaos Resilient Fault injection, failover, survival testing, self-healing
Memory Session context, task distillation, vector similarity search
MCP Ready Connect any Model Context Protocol server for tools and data
Multi-Agent Leader/sub orchestration with automatic failover
Observability OpenTelemetry traces, structured logs, Prometheus metrics

CLI

ares serve              # Start full agent monitoring (LLM + MCP + dashboard)
ares agent list         # List all registered agents
ares arena run/validate/list/serve/survival/inspect  # Chaos engineering scenarios
ares evolution run/status         # Runtime evolution
ares flight inspect/replay        # Inspect and replay task recordings
ares workflow run <id> <input>    # Execute a workflow
ares knowledge build <goal>       # Build a knowledge graph (via HTTP API)
ares mcp-null serve     # Start minimal MCP null server (stdio)
ares db migrate/setup-test/create-table/check-rls  # Database management
ares init               # Scaffold a new project (main.go + ares.yaml)
ares run                # Run agent from config file
ares bench              # Quick performance benchmark
ares doctor             # Diagnose environment (LLM key, Ollama, Git)
ares version            # Show version

SDK

rt := sdk.MustNew(
    sdk.WithOpenAI("gpt-4o-mini"),          // or WithOllama, WithAnthropic
    sdk.WithDefaultMemory(),                 // session history
    sdk.WithEvolution(),                     // strategy evolution
    sdk.WithMCP(sdk.MCPConn{                 // MCP server tools
        Name: "my-server", Command: "/path/to/server", Args: []string{"serve"},
    }),
)
defer rt.Close()

// Agent with tools and human-in-the-loop.
agent := rt.NewAgent("assistant",
    sdk.WithInstruction("You are helpful."),
    sdk.WithTools(calculatorTool, weatherTool),
    sdk.WithHumanInput(approveFn),
)
result, _ := agent.Run(ctx, "Calculate 15*23")

// Streaming response.
ch, _ := agent.Stream(ctx, "Tell me a story")
for chunk := range ch { fmt.Print(chunk.Content) }

// Multi-agent team.
team := rt.NewTeam("project", leaderAgent, []*Agent{memberAgent})
teamResult, _ := team.Run(ctx, "Research and write")

See examples/README.md for 9 hands-on examples.

Articles

Deep dives into ARES internals:

English 中文
Architecture 架构
Evolution 进化
MCP Integration MCP 集成
Workflow Engine 工作流引擎
Memory & Distillation 记忆与蒸馏
Chaos Arena 混沌测试

Architecture

graph TB
    User["User / CLI"] --> SDK

    subgraph SDK ["SDK Layer (sdk/)"]
        RT["Runtime<br/>MustNew / New"]
        A["Agent<br/>Run / Stream"]
        T["Team<br/>Multi-Agent"]
        CFG["Config<br/>YAML + Options"]
        EV["Evolve()<br/>GA Strategy Evolution"]
    end

    SDK --> LLM
    SDK --> Tools
    SDK --> Memory
    SDK --> Evo

    subgraph LLM ["LLM Providers"]
        OAI["OpenAI"]
        OLL["Ollama"]
        ANTH["Anthropic"]
        OR["OpenRouter"]
    end

    subgraph Tools ["Tool System"]
        BT["Built-in<br/>calculator, search..."]
        MCP["MCP Servers<br/>Stdio / SSE"]
        CT["Custom Tools<br/>ToolFunc"]
    end

    subgraph Memory ["Memory System"]
        SES["Session Context"]
        DIST["Task Distillation"]
        VEC["Vector Search"]
        CONF["Config<br/>max_history, session_ttl..."]
        MP["Memory Patch Executor<br/>Runtime Evolution"]
    end

    subgraph Evo ["GA Evolution Engine"]
        direction TB
        POP["Population<br/>N individuals"]
        SEL["7 Selection Operators<br/>tournament/rank/nsga2..."]
        CROSS["3 Crossover Types<br/>uniform/two_point/segment"]
        MUT["6 Mutation Types<br/>param/swap/inversion/scramble..."]
        SCORE["Experience-Guided Scoring<br/>multi-objective"]
        SS["Steady-State GA<br/>online learning mode"]
        SHARE["Fitness Sharing<br/>SelectionScore preservation"]
    end

    POP --> SEL --> CROSS --> MUT --> SCORE
    SCORE --> POP
    SS -.-> POP

    subgraph RuntimeEvo ["Runtime Evolution Pipeline"]
        direction TB
        TICKER["Background Ticker<br/>5min interval"]
        SCHED["Scheduler<br/>OnAgentEnd callback"]
        ADAPTER["GenomePopulationAdapter<br/>Run()"]
        GENOME["Genomes<br/>Workflow / Scheduler / Knowledge<br/>Recovery / Planner / Memory"]
        DIFF["Diff Engine<br/>4 Differs"]
        COORD["Coordinator<br/>Apply / Reject / Delay"]
        EXEC["Executors<br/>Graph / Recovery / Knowledge / Memory"]
        STORE["Strategy Store<br/>Active Strategy"]
        AGENT["Live Agent<br/>consume evolved params"]
    end

    TICKER --> ADAPTER
    SCHED --> ADAPTER
    ADAPTER --> GENOME
    GENOME --> DIFF
    DIFF --> COORD
    COORD --> EXEC
    ADAPTER --> STORE
    STORE --> AGENT

    Evo --> ADAPTER
    AGENT --> LLM
    AGENT --> Tools
    AGENT --> Memory

    subgraph CLI ["CLI (cmd/ares/)"]
        INIT["ares init"]
        RUN["ares run"]
        BENCH["ares bench"]
        DOCTOR["ares doctor"]
        EVO["ares evolution"]
        ARENA["ares arena"]
    end

    subgraph EX ["Examples"]
        QS["01 Quickstart"]
        TC["02 Tool Calling"]
        DAG["03 DAG Workflow"]
        MA["04 Multi-Agent"]
        EVO_DEMO["05 Evolution Demo"]
        CHAOS["06 Chaos Resilience"]
        HIL["07 Human-in-Loop"]
        GA_FULL["10 GA Full Evolution"]
    end

    style SDK fill:#1e3a5f,stroke:#3b82f6,color:#fff
    style LLM fill:#1a2332,stroke:#64748b
    style Tools fill:#1a2332,stroke:#64748b
    style Memory fill:#1a2332,stroke:#64748b
    style Evo fill:#1a2332,stroke:#64748b
    style RuntimeEvo fill:#2d1b69,stroke:#8b5cf6,color:#fff
    style CLI fill:#2d1b69,stroke:#8b5cf6,color:#fff
    style EX fill:#1a3a2a,stroke:#22c55e

Data Flow

sequenceDiagram
    participant U as User
    participant S as SDK
    participant A as Agent
    participant GA as GA Engine
    participant C as Coordinator
    participant E as Executors
    participant M as Memory

    U->>S: rt.Evolve(agent, task)
    S->>GA: Create Population(10)
    loop 3 generations
        GA->>GA: ScoreAgents(execution results)
        GA->>GA: Evolve(selection → crossover → mutation)
    end
    GA->>S: BestStrategy params
    S->>A: applyEvolvedParams(tool_selector, search_depth, scheduler...)

    Note over S,A: Strategy params applied to live agent

    U->>A: agent.Run(task)
    A->>M: Read strategy, load tools
    A->>A: Execute with evolved params
    A->>C: Submit evidence
    C->>E: Apply patches if needed

    Note over GA,C: Background: ticker + scheduler trigger evolution
    loop Every 5min
        GA->>GA: Run evolution cycle
        GA->>C: submitToCoordinator(patches)
        C->>E: Evaluate & Apply
    end

Cookbook

Recipe Code
Chat Agent 20-line conversational agent
Tool Calling Custom tools for LLM function calling
Multi-Agent Leader/member team orchestration
Memory Persistent conversation context
Coding Agent Code generation with specialized instructions
Code Review Automated PR review
GitHub Agent Issue and PR automation

Project Structure

├── sdk/           # Unified SDK (package sdk)
├── cmd/ares/      # CLI entry point (evolution status/run)
├── examples/      # 24+ runnable examples
│   └── runtime_evolution/  # Evolution demos (basic / knowledge / full)
├── docs/          # Documentation and articles
├── api/           # Public API interfaces
└── internal/
    ├── evolution/         # Runtime evolution system
    │   ├── genome/        # 5 Genome implementations (Workflow/Scheduler/Knowledge/Recovery/Prompt)
    │   ├── diff/          # Diff Engine (4 Differ implementations)
    │   ├── coordinator/   # Evolution Coordinator (7 PatchSources, PolicyGenome)
    │   ├── patch/         # RuntimePatch type + Registry + Apply/ApplySet
    │   └── llm_adapter.go # LLM participant adapter
    ├── ares_evolution/    # Strategy-level GA (population, NSGA-II, crossover, mutation, experience)
    ├── evidence/          # Evidence data primitive + MemoryStore
    ├── workflow/
    │   ├── graph/         # GraphPatchExecutor (7 patch types)
    │   └── engine/        # RecoveryPatchExecutor
    ├── knowledge/
    │   └── runtime/       # KnowledgePatchExecutor
    └── ares_bootstrap/    # Assembly wiring (ProvideNewEvolution)

Runtime Evolution

ARES's runtime evolution system is evidence-driven: every execution, fault, and insight produces Evidence, which feeds into the evolution cycle. The system evolves DAG topology, scheduler selection, knowledge planner parameters, and recovery strategies — all in production, without restarts.

Architecture

Execution → Evidence → Genome → Candidate → Diff Engine → RuntimePatch → Coordinator → Apply
Component Role Sources
5 Genomes Generate candidate configurations via mutation + crossover workflow, scheduler, knowledge, recovery, prompt
4 Differs Compare old vs new snapshots → produce RuntimePatches workflow, knowledge, scheduler, recovery
Coordinator Decides Apply/Reject/Delay for each PatchProposal GA, Chaos, AKF, LLM, Human, K8s, Rule
3 Executors Apply patches to live runtime Graph, Knowledge, Recovery
LLM Adapter Converts natural-language suggestions into PatchProposals parsed format → Coordinator

Key design: LLM is a participant, not the leader. The Coordinator treats all 7 PatchSource values equally. No source has privileged access.

Benchmarks (Apple M3 Max)

BenchmarkWorkflowGenome_Mutate     309k   7.1µs  11.4KB  155 allocs
BenchmarkSchedulerGenome_Mutate    3.3M   0.4µs   719B    15 allocs
BenchmarkKnowledgeGenome_Mutate    2.8M   0.4µs   960B    11 allocs
BenchmarkRecoveryGenome_Mutate     2.2M   0.5µs  1.1KB    21 allocs
BenchmarkDiffEngine_Workflow       2.9M   0.4µs   256B     3 allocs
BenchmarkCoordinator_Evaluate      217M   5.4ns     0B      0 allocs
BenchmarkFullEvolutionCycle        206k   5.3µs  8.0KB   109 allocs

CLI

ares evolution status   # Show genomes, differs, coordinator state
ares evolution run      # Run one evolution cycle

Examples

go run examples/11-knowledge-import/ --dir ./notes          # Ingest markdown into pgvector
go run examples/11-knowledge-import/ --ask "question"       # RAG query against KB
go run examples/11-knowledge-import/ --evolve "task"        # GA evolution on import
go run examples/11-knowledge-import/ --chat                 # Interactive chat with tools
go run examples/11-knowledge-import/ --team --dir ./notes   # Multi-agent import
go run examples/11-knowledge-import/ --chaos-fail 0.3       # With fault injection
go run examples/11-knowledge-import/akg/                    # Build AKG from KB
go run examples/runtime_evolution/basic/      # Full end-to-end evolution demo
go run examples/runtime_evolution/knowledge/  # Knowledge parameter evolution
go run examples/runtime_evolution/full/       # All 4 genomes + real executors

Strategy Evolution (GA)

Beyond runtime-level evolution, ARES includes a strategy-level Genetic Algorithm that optimizes agent inference parameters (temperature, top_k, prompt templates, tool configs) through population-based search. The system evolves a population of strategies across generations using selection, crossover, and mutation, with zero-cost background evolution cycles.

Key Features

Feature Description
NSGA-II Multi-Objective 4 default dimensions (success_rate 0.40, quality 0.25, cost 0.20, latency 0.15) with direction-aware Pareto dominance
Steady-State GA Configurable replace rate (0.1–0.5, default 0.3) — replaces only the worst individuals each generation
Score / SelectionScore Canonical score preserved; selection score adjusted by fitness sharing for diversity
Fitness Sharing 3 strategies — full O(n²), reservoir sampling, spatial grid index (for >500 individuals)
3 Crossover Types Uniform (per-gene), Two-Point (swap segment), Segment (contiguous block)
6 Mutation Types Parameter, Prompt, Tool, Swap, Inversion, Scramble
Evolution Callbacks OnGeneration / OnFitness / OnMutation / OnCrossover
Termination MaxGenerations + TargetFitness (stops when BestEverScore ≥ target)
Generation History Per-generation snapshots with metadata
Experience System 3-tier pipeline: ToolCallRecord → RawExperience → NormalizedExperience → EvolutionHint → GuidanceProvider

Benchmarks (Apple M3 Max)

BenchmarkPopulation_Init-10           100   11.7ms    2.5MB   32 allocs
BenchmarkPopulation_Select-10         300    4.1ms    1.1MB   12 allocs
BenchmarkPopulation_Mutate-10         500    2.5ms    708KB   10 allocs
BenchmarkDreamCycle_FullCycle-10       50   24.3ms    5.8MB   55 allocs
BenchmarkNondominatedSort-10         1000    1.8ms    256KB    8 allocs

Examples

go run examples/10-ga-full-evolution/main.go   # Full GA evolution demo
go run examples/05-evolution-demo/main.go       # Pre-NSGA-II evolution demo

License

Apache 2.0

Acknowledgments

ARES's genetic algorithm implementation was inspired by the design and features of PyGAD — the Python genetic algorithm library by Ahmed F. Gad. PyGAD's architecture, operator design, and multi-objective optimization capabilities served as a valuable reference for building the GA engine in this project.

We recommend PyGAD for anyone looking for a mature, well-documented GA library in Python:

Additional GA concepts and terminology follow the standard definitions from the Genetic Algorithm article on Wikipedia.

Directories

Path Synopsis
api
bootstrap
Package bootstrap provides factory functions for creating ARES modules.
Package bootstrap provides factory functions for creating ARES modules.
client
Package client provides a library-style entry point for embedding GoAgent into other Go applications.
Package client provides a library-style entry point for embedding GoAgent into other Go applications.
core
Package core provides core abstractions for agent operations.
Package core provides core abstractions for agent operations.
discovery
Package discovery provides the public API for service discovery.
Package discovery provides the public API for service discovery.
evolution
Package evolution provides the public API for strategy evolution, including the DreamCycle orchestrator, GA Population, mutation, and promotion subsystems.
Package evolution provides the public API for strategy evolution, including the DreamCycle orchestrator, GA Population, mutation, and promotion subsystems.
evolution/genome
Package genome provides the public API for genetic algorithm genome operations, including crossover (recombination) operators for combining parent strategies.
Package genome provides the public API for genetic algorithm genome operations, including crossover (recombination) operators for combining parent strategies.
evolution/mutation
Package mutation provides the public API for strategy mutation in the evolution system.
Package mutation provides the public API for strategy mutation in the evolution system.
flight
Package flight provides the public API for flight recording and observability.
Package flight provides the public API for flight recording and observability.
handler
Package handler provides HTTP handlers for the GoAgent API.
Package handler provides HTTP handlers for the GoAgent API.
mcp
Package mcp ...
Package mcp ...
memory
Package memory provides the public API for agent conversation memory management.
Package memory provides the public API for agent conversation memory management.
memory/distillation
Package distillation extracts structured knowledge from conversations.
Package distillation extracts structured knowledge from conversations.
router
Package router provides HTTP routing for the GoAgent API.
Package router provides HTTP routing for the GoAgent API.
service/agent
Package agent provides the public API for agent lifecycle management.
Package agent provides the public API for agent lifecycle management.
service/arena
Package arena provides the public API for chaos engineering operations.
Package arena provides the public API for chaos engineering operations.
service/callbacks
Package callbacks provides the public API for event callback registration.
Package callbacks provides the public API for event callback registration.
service/dashboard
Package dashboard provides the public API for the monitoring dashboard.
Package dashboard provides the public API for the monitoring dashboard.
service/eval
Package evaluation provides the public API for agent output evaluation.
Package evaluation provides the public API for agent output evaluation.
service/events
Package events — event store errors.
Package events — event store errors.
service/evolution
Package evolution provides the public API for genetic algorithm evolution.
Package evolution provides the public API for genetic algorithm evolution.
service/flight
Package flight provides the public API for flight recording and replay.
Package flight provides the public API for flight recording and replay.
service/knowledge
Package knowledge provides the public HTTP API for AKF.
Package knowledge provides the public HTTP API for AKF.
service/llm
Package llm provides the public API for LLM operations.
Package llm provides the public API for LLM operations.
service/memory
Package memory provides the public API for memory management.
Package memory provides the public API for memory management.
service/runtime
Package ares_runtime ...
Package ares_runtime ...
service/workflow
Package workflow provides workflow orchestration service implementation.
Package workflow provides workflow orchestration service implementation.
tools
Package tools ...
Package tools ...
cmd
arena command
Package main ...
Package main ...
ares command
Package main — ARES agent CLI commands.
Package main — ARES agent CLI commands.
check_rls command
Package main ...
Package main ...
create_distilled_table command
Package main ...
Package main ...
embedding-mcp command
Package main ...
Package main ...
flight command
Command flight provides the Agent Flight Recorder CLI.
Command flight provides the Agent Flight Recorder CLI.
mcp-null command
Package main ...
Package main ...
migrate_db command
Package main ...
Package main ...
monitor-demo command
monitor-live command
Package main ...
Package main ...
setup_test_db command
Package main ...
Package main ...
Package compat is the ARES Compatibility Layer — the ecosystem entry point.
Package compat is the ARES Compatibility Layer — the ecosystem entry point.
llm
Package llm is the LLM compatibility layer of ARES.
Package llm is the LLM compatibility layer of ARES.
llm/ollama
Package ollama is the official Ollama LLM adapter for ARES.
Package ollama is the official Ollama LLM adapter for ARES.
llm/openai
Package openai is the official OpenAI-compatible LLM adapter for ARES.
Package openai is the official OpenAI-compatible LLM adapter for ARES.
loader
Package loader is the document-loader compatibility layer of ARES.
Package loader is the document-loader compatibility layer of ARES.
loader/html
Package html is the official HTML document loader for ARES.
Package html is the official HTML document loader for ARES.
loader/markdown
Package markdown is the official Markdown document loader for ARES.
Package markdown is the official Markdown document loader for ARES.
loader/pdf
Package pdf is the official PDF document loader for ARES.
Package pdf is the official PDF document loader for ARES.
protocol
Package protocol is the wire-protocol compatibility layer of ARES.
Package protocol is the wire-protocol compatibility layer of ARES.
protocol/mcp
Package mcp is the official MCP (Model Context Protocol) adapter for ARES.
Package mcp is the official MCP (Model Context Protocol) adapter for ARES.
protocol/openai_api
Package openaiapi is the official OpenAI-API-compatible protocol adapter for ARES.
Package openaiapi is the official OpenAI-API-compatible protocol adapter for ARES.
tool
Package tool is the tool-shell compatibility layer of ARES.
Package tool is the tool-shell compatibility layer of ARES.
tool/builtin
Package builtin holds the official builtin tool adapters for ARES.
Package builtin holds the official builtin tool adapters for ARES.
vector
Package vector is the vector-store compatibility layer of ARES.
Package vector is the vector-store compatibility layer of ARES.
vector/pgvector
Package pgvector is the official pgvector-backed vector store adapter for ARES.
Package pgvector is the official pgvector-backed vector store adapter for ARES.
Package evaluation provides a framework for benchmarking ARES agent capabilities.
Package evaluation provides a framework for benchmarking ARES agent capabilities.
examples
01-quickstart command
Quickstart — the simplest way to get started with ARES.
Quickstart — the simplest way to get started with ARES.
02-tool-calling command
Tool calling — demonstrates how to create and use multiple tools with ARES.
Tool calling — demonstrates how to create and use multiple tools with ARES.
03-dag-workflow command
DAG workflow — demonstrates graph-based workflow with linear and conditional execution, plus the new DAG flexible features: conditional routing, controlled loops, subgraph nesting.
DAG workflow — demonstrates graph-based workflow with linear and conditional execution, plus the new DAG flexible features: conditional routing, controlled loops, subgraph nesting.
04-multi-agent command
Multi-agent — demonstrates team-based leader/member orchestration with ARES.
Multi-agent — demonstrates team-based leader/member orchestration with ARES.
05-evolution-demo command
Evolution demo — demonstrates strategy evolution to improve agent performance.
Evolution demo — demonstrates strategy evolution to improve agent performance.
06-chaos-resilience command
Chaos resilience — demonstrates real failure handling and self-healing patterns.
Chaos resilience — demonstrates real failure handling and self-healing patterns.
07-human-in-loop command
Human-in-loop — demonstrates human approval before executing tool calls.
Human-in-loop — demonstrates human approval before executing tool calls.
08-mcp-integration command
MCP integration — demonstrates connecting to an MCP server and using its tools.
MCP integration — demonstrates connecting to an MCP server and using its tools.
09-full-app command
Full app — demonstrates a complete ARES application with web UI.
Full app — demonstrates a complete ARES application with web UI.
10-ga-full-evolution command
GA Full Evolution Demo — comprehensive GA evolution demonstration.
GA Full Evolution Demo — comprehensive GA evolution demonstration.
11-knowledge-import command
This file provides Arena-style chaos injection and Resurrection-style agent recovery for the knowledge base example.
This file provides Arena-style chaos injection and Resurrection-style agent recovery for the knowledge base example.
11-knowledge-import/akg command
Command akg-build — builds an AKG knowledge graph from knowledge_chunks_1024 using the existing PGProvider + KnowledgeRuntime pipeline.
Command akg-build — builds an AKG knowledge graph from knowledge_chunks_1024 using the existing PGProvider + KnowledgeRuntime pipeline.
custom-store command
custom-store demonstrates implementing a custom ServiceStore for persistent service discovery (SQLite, Postgres, etc.).
custom-store demonstrates implementing a custom ServiceStore for persistent service discovery (SQLite, Postgres, etc.).
discovery command
discovery demonstrates the Service Discovery Engine.
discovery demonstrates the Service Discovery Engine.
eval command
Eval — runs concrete evaluation scenarios to measure ARES capabilities.
Eval — runs concrete evaluation scenarios to measure ARES capabilities.
external-tools command
external-tools demonstrates how external projects use the ares public API.
external-tools demonstrates how external projects use the ares public API.
graph_demo command
Graph demo — demonstrates graph construction, scheduling, conditional edges, and dynamic routing in the ARES Graph system.
Graph demo — demonstrates graph construction, scheduling, conditional edges, and dynamic routing in the ARES Graph system.
knowledge-fabric command
AKF demo — demonstrates the complete ARES Knowledge Fabric pipeline.
AKF demo — demonstrates the complete ARES Knowledge Fabric pipeline.
mcp-registry command
mcp-registry demonstrates MCP service discovery and lifecycle management.
mcp-registry demonstrates MCP service discovery and lifecycle management.
runtime_evolution/basic command
Runtime Evolution Demo — 展示 WorkflowGenome + Diff Engine + Coordinator 完整进化闭环
Runtime Evolution Demo — 展示 WorkflowGenome + Diff Engine + Coordinator 完整进化闭环
runtime_evolution/full command
Full Cycle Demo — 全部 Genome + Diff Engine + Coordinator + 真实 Executor 的完整闭环
Full Cycle Demo — 全部 Genome + Diff Engine + Coordinator + 真实 Executor 的完整闭环
runtime_evolution/knowledge command
Knowledge Evolution Demo — KnowledgeGenome 参数进化 + KnowledgePatchExecutor
Knowledge Evolution Demo — KnowledgeGenome 参数进化 + KnowledgePatchExecutor
internal
agents
Package agent provides error definitions for agent service.
Package agent provides error definitions for agent service.
agents/leader
Package leader provides the Leader Agent implementation for multi-agent orchestration.
Package leader provides the Leader Agent implementation for multi-agent orchestration.
api_impl
Package apiimpl ...
Package apiimpl ...
api_impl/agent
Package agent provides error definitions for agent operations.
Package agent provides error definitions for agent operations.
ares_arena
Package arena provides a chaos engineering layer that proves ares is a self-healing runtime.
Package arena provides a chaos engineering layer that proves ares is a self-healing runtime.
ares_bootstrap
Package ares_bootstrap orchestrates component assembly.
Package ares_bootstrap orchestrates component assembly.
ares_callbacks
Package callbacks provides lifecycle event hooks for LLM calls and agent execution.
Package callbacks provides lifecycle event hooks for LLM calls and agent execution.
ares_config
package config - provides configuration loading and validation for ares.
package config - provides configuration loading and validation for ares.
ares_ctxutil
Package ctxutil provides context utilities for tracing and lifecycle management.
Package ctxutil provides context utilities for tracing and lifecycle management.
ares_eval
Package ares_eval ...
Package ares_eval ...
ares_eval/service
Package evalapi ...
Package evalapi ...
ares_events
Package events defines event sourcing types and the event store interface.
Package events defines event sourcing types and the event store interface.
ares_evolution
Package evolution provides GA mode integration for the DreamCycle orchestrator.
Package evolution provides GA mode integration for the DreamCycle orchestrator.
ares_evolution/experience
Package experience provides evidence aggregation for the GA/Memory/Tool fusion system.
Package experience provides evidence aggregation for the GA/Memory/Tool fusion system.
ares_evolution/genome
Package genome provides genetic algorithm crossover (recombination) operators for combining two parent strategies into a child strategy.
Package genome provides genetic algorithm crossover (recombination) operators for combining two parent strategies into a child strategy.
ares_evolution/mutation
Package mutation ...
Package mutation ...
ares_evolution/promotion
Package promotion provides strategy promotion and demotion logic.
Package promotion provides strategy promotion and demotion logic.
ares_evolution/scoring
Package scoring ...
Package scoring ...
ares_evolution/service
Package evolution provides error definitions for the evolution service.
Package evolution provides error definitions for the evolution service.
ares_experience
Package experience provides experience conflict resolution service.
Package experience provides experience conflict resolution service.
ares_experience/service
Package experience provides experience conflict resolution service.
Package experience provides experience conflict resolution service.
ares_flight
Package flight provides runtime intelligence for ares agents.
Package flight provides runtime intelligence for ares agents.
ares_mcp
Package ares_mcp ...
Package ares_mcp ...
ares_memory
Package memory provides unified memory management for the StyleAgent framework.
Package memory provides unified memory management for the StyleAgent framework.
ares_memory/context
Package context ...
Package context ...
ares_memory/distillation
Package distillation provides memory distillation functionality for agent experience extraction.
Package distillation provides memory distillation functionality for agent experience extraction.
ares_memory/embedding
Package embedding provides canonical embedding types and a unified pipeline for generating vector embeddings across memory distillation, storage, and retrieval.
Package embedding provides canonical embedding types and a unified pipeline for generating vector embeddings across memory distillation, storage, and retrieval.
ares_memory/push
Package push provides active knowledge recommendation to strategies.
Package push provides active knowledge recommendation to strategies.
ares_memory/report
Package report provides human-readable evolution report generation.
Package report provides human-readable evolution report generation.
ares_protocol/ahp
Package ahp ...
Package ahp ...
ares_quant
Package ares_quant provides MCP-compatible tools for quantitative trading analysis.
Package ares_quant provides MCP-compatible tools for quantitative trading analysis.
ares_quant/dataflow
Package dataflow provides anti-hallucination infrastructure for market data, including symbol normalization, vendor routing, data validation, and verified snapshot construction.
Package dataflow provides anti-hallucination infrastructure for market data, including symbol normalization, vendor routing, data validation, and verified snapshot construction.
ares_quant/errors
Package errors provides shared sentinel errors for ares_quant sub-packages.
Package errors provides shared sentinel errors for ares_quant sub-packages.
ares_quant/indicators
Package indicators provides technical analysis computations.
Package indicators provides technical analysis computations.
ares_quant/market
Package market ...
Package market ...
ares_quant/marketmaking
Package marketmaking provides the core domain model for market-making operations.
Package marketmaking provides the core domain model for market-making operations.
ares_quant/marketmaking_api
Package marketmaking provides a domain-level facade for market-making and quantitative trading operations.
Package marketmaking provides a domain-level facade for market-making and quantitative trading operations.
ares_quant/portfolio
Package portfolio provides backtesting and portfolio simulation for quantitative trading strategies.
Package portfolio provides backtesting and portfolio simulation for quantitative trading strategies.
ares_quant/research
Package research ...
Package research ...
ares_quant/research/agents
Package agents provides prompt building, agent interfaces, and execution infrastructure for the quantitative research pipeline.
Package agents provides prompt building, agent interfaces, and execution infrastructure for the quantitative research pipeline.
ares_quant/store
Package store provides persistent storage for quant trading data.
Package store provides persistent storage for quant trading data.
ares_ratelimit
Package ares_ratelimit ...
Package ares_ratelimit ...
ares_runtime
Package runtime defines the plugin contract for extending workflow execution.
Package runtime defines the plugin contract for extending workflow execution.
ares_shutdown
Package ares_shutdown ...
Package ares_shutdown ...
core/errors
Package errors provides structured application error types and error strategy configuration.
Package errors provides structured application error types and error strategy configuration.
dashboard
package dashboard — unified API v2.
package dashboard — unified API v2.
discovery
Package discovery provides a pluggable service discovery engine.
Package discovery provides a pluggable service discovery engine.
discovery/providers
Package providers implements DiscoveryProvider for various sources.
Package providers implements DiscoveryProvider for various sources.
evidence
Package evidence provides the universal data primitive for ARES.
Package evidence provides the universal data primitive for ARES.
evolution
Package evolution provides LLM adapters for the runtime evolution system.
Package evolution provides LLM adapters for the runtime evolution system.
evolution/coordinator
Package coordinator provides the central decision-maker for runtime patches.
Package coordinator provides the central decision-maker for runtime patches.
evolution/diff
Package diff provides the Runtime Diff Engine.
Package diff provides the Runtime Diff Engine.
evolution/genome
Package genome provides the plugin interface for evolvable runtime components.
Package genome provides the plugin interface for evolvable runtime components.
evolution/patch
Package patch provides the universal mutation language for ARES Runtime.
Package patch provides the universal mutation language for ARES Runtime.
knowledge
Package knowledge provides the ARES Knowledge Fabric (AKF) core types for building, storing, and compiling dynamic cognitive graphs.
Package knowledge provides the ARES Knowledge Fabric (AKF) core types for building, storing, and compiling dynamic cognitive graphs.
knowledge/adapter
Package adapter provides bridges between existing ARES subsystems and AKF.
Package adapter provides bridges between existing ARES subsystems and AKF.
knowledge/compiler
Package compiler compiles a WorkingGraph into multiple output formats (Prompt, Markdown, JSON, XML, ToolSchema) for LLM consumption.
Package compiler compiles a WorkingGraph into multiple output formats (Prompt, Markdown, JSON, XML, ToolSchema) for LLM consumption.
knowledge/linker
Package linker provides pluggable Relation generators for AKF.
Package linker provides pluggable Relation generators for AKF.
knowledge/mcp
Package mcp provides MCP tool definitions for ARES Knowledge Fabric (AKF).
Package mcp provides MCP tool definitions for ARES Knowledge Fabric (AKF).
knowledge/pipeline
Package pipeline — LLM-based summarizer for AKF.
Package pipeline — LLM-based summarizer for AKF.
knowledge/planner
Package planner provides knowledge planning, source discovery, and query planning.
Package planner provides knowledge planning, source discovery, and query planning.
knowledge/provider
Package provider defines the GraphProvider interface for pluggable external data sources.
Package provider defines the GraphProvider interface for pluggable external data sources.
knowledge/provider/code
Package code implements a GraphProvider that analyses Go source directories and emits functions, types, and interfaces as KnowledgeObjects.
Package code implements a GraphProvider that analyses Go source directories and emits functions, types, and interfaces as KnowledgeObjects.
knowledge/provider/evolution
Package evolution provides a GraphProvider that reads from the evolution system's StrategyStore and streams strategies as KnowledgeObjects.
Package evolution provides a GraphProvider that reads from the evolution system's StrategyStore and streams strategies as KnowledgeObjects.
knowledge/provider/memory
Package memory provides a GraphProvider that wraps a memory service, converting historical task data into KnowledgeObject streams.
Package memory provides a GraphProvider that wraps a memory service, converting historical task data into KnowledgeObject streams.
knowledge/provider/mysql
Package mysql implements a GraphProvider for external MySQL databases.
Package mysql implements a GraphProvider for external MySQL databases.
knowledge/provider/postgres
Package postgres implements a GraphProvider for external PostgreSQL databases.
Package postgres implements a GraphProvider for external PostgreSQL databases.
knowledge/provider/vector
Package vector implements a GraphProvider for any VectorStore backend.
Package vector implements a GraphProvider for any VectorStore backend.
knowledge/retriever
Package retriever implements AKG.md §8 — Intent-driven knowledge retrieval.
Package retriever implements AKG.md §8 — Intent-driven knowledge retrieval.
knowledge/runtime
Package runtime provides the KnowledgeRuntime — the core execution engine of AKF.
Package runtime provides the KnowledgeRuntime — the core execution engine of AKF.
knowledge/store/memory
Package memorystore provides an in-memory KnowledgeStore implementation.
Package memorystore provides an in-memory KnowledgeStore implementation.
knowledge/store/postgres
Package postgresstore implements KnowledgeStore for PostgreSQL.
Package postgresstore implements KnowledgeStore for PostgreSQL.
knowledge/store/sqlite
Package sqlitestore implements KnowledgeStore for SQLite.
Package sqlitestore implements KnowledgeStore for SQLite.
knowledge/workflow
Package workflow integrates AKF (ARES Knowledge Fabric) with the DAG workflow engine.
Package workflow integrates AKF (ARES Knowledge Fabric) with the DAG workflow engine.
llm
Package llm provides LLM client functionality for various providers.
Package llm provides LLM client functionality for various providers.
llm/output
Package output ...
Package output ...
llmservice
Package llm provides error definitions for LLM service.
Package llm provides error definitions for LLM service.
logger
Package logger provides module-scoped structured logging helpers.
Package logger provides module-scoped structured logging helpers.
memoryservice
Package memory provides error definitions for memory service.
Package memory provides error definitions for memory service.
monitoring
Package monitoring provides the ARES Console monitoring plugin.
Package monitoring provides the ARES Console monitoring plugin.
monitoring/adapter
Package adapter bridges dashboard intelligence into monitoring console.
Package adapter bridges dashboard intelligence into monitoring console.
monitoring/dag
Package dag provides the node interaction engine for ARES Console.
Package dag provides the node interaction engine for ARES Console.
monitoring/data
Package data provides state aggregation for the ARES Console monitoring plugin.
Package data provides state aggregation for the ARES Console monitoring plugin.
monitoring/eventutil
Package eventutil provides shared helpers for extracting typed values from ares_events.Event payloads.
Package eventutil provides shared helpers for extracting typed values from ares_events.Event payloads.
monitoring/tabs
Package tabs implements component-level tabs for the ARES Console monitoring plugin.
Package tabs implements component-level tabs for the ARES Console monitoring plugin.
plugins/resurrection
Package resurrection ...
Package resurrection ...
retrievalservice
Package retrieval provides error definitions for retrieval service.
Package retrieval provides error definitions for retrieval service.
storage
package storage defines the vector storage interface.
package storage defines the vector storage interface.
storage/memory
package memory provides an in-memory vector store implementation.
package memory provides an in-memory vector store implementation.
storage/postgres
Package postgres provides PostgreSQL database operations for the storage system.
Package postgres provides PostgreSQL database operations for the storage system.
storage/postgres/adapters
Package adapters provides format conversion layer for storage operations.
Package adapters provides format conversion layer for storage operations.
storage/postgres/embedding
Package embedding ...
Package embedding ...
storage/postgres/models
Package models defines data structures for the storage system.
Package models defines data structures for the storage system.
storage/postgres/query
Package query ...
Package query ...
storage/postgres/repositories
Package repositories provides data access layer for storage system.
Package repositories provides data access layer for storage system.
storage/postgres/services
Package services ...
Package services ...
tools/planner
Package planner - capability definition model.
Package planner - capability definition model.
tools/resources/agent
Package agent ...
Package agent ...
tools/resources/builtin/embedding
Package builtin ...
Package builtin ...
tools/resources/builtin/execution
Package builtin ...
Package builtin ...
tools/resources/builtin/file
Package builtin ...
Package builtin ...
tools/resources/builtin/hash
Package builtin - cryptographic hash and base64 encoding tools.
Package builtin - cryptographic hash and base64 encoding tools.
tools/resources/builtin/network
Package builtin ...
Package builtin ...
tools/resources/builtin/pdf
Package builtin ...
Package builtin ...
tools/resources/builtin/planning
Package builtin ...
Package builtin ...
tools/resources/formatter
Package formatter ...
Package formatter ...
truncate
Package truncate provides rune-safe string truncation utilities.
Package truncate provides rune-safe string truncation utilities.
workflow/engine
Package engine ...
Package engine ...
workflow/graph
Package graph provides dynamic agent orchestration with pluggable scheduling.
Package graph provides dynamic agent orchestration with pluggable scheduling.
Package ares provides the top-level, unified entry point for the ARES agent runtime.
Package ares provides the top-level, unified entry point for the ARES agent runtime.
services
embedding command
Simple embedding bridge that forwards requests to Ollama's embedding API.
Simple embedding bridge that forwards requests to Ollama's embedding API.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL