Ergo Core

English | 简体中文

Pure Go execution SDK for applications that ship their own Ergo Agents.

Ergo draws inspiration from Pi and preserves selected behavioral and resource compatibility. Its independent, self-contained pure-Go Runtime provides the execution foundation.

This is a generated, read-only distribution of the canonical github.com/ageniti/ergo-agent repository. Submit issues, changes, and releases there. Do not edit this repository directly.

What is included

• Agent execution loop, tools, sessions, compaction, MCP, and Extension API;
• Provider adapters and model/image contracts;
• Agent profile, prompt, Skill, and package loaders;
• one starter Agent profile template that uses the built-in system prompt;
• optional native Go integrations such as Bocha web_search.

What is excluded

• Chief, Coding, and all product Agent profiles;
• default system prompts and bundled Skills;
• CLI/application examples and the ECS/MySQL control plane;
• JavaScript Extension loading.

Install

go get github.com/ageniti/ergo-core/runtime

import ergoruntime "github.com/ageniti/ergo-core/runtime"

agentRuntime := ergoruntime.New("./resources")
err := agentRuntime.Run(ctx, map[string]any{
    "agentId": "my-agent",
    "prompt":  "Complete the assigned task.",
    "cwd":     ".",
}, nil, sink)

Core uses explicit entry selection, so every run provides agentId. Use github.com/ageniti/ergo-agent when you want Ergo's complete default Agent suite or the ergo-agent scaffolding CLI.

License

AGPL-3.0-only OR a separately executed Ergo Commercial License. See LICENSE and LICENSE-COMMERCIAL.md.