@stigmer/protos

Stigmer

An open-source AI agent platform.

Define agents in YAML, deploy with one command, call from any app via API. Run locally with SQLite or connect to Stigmer Cloud for production. Bring your own LLM — Anthropic, OpenAI, or Ollama.

Quick Start

# Install
brew install stigmer/tap/stigmer

# Start the server (interactive LLM setup on first run)
stigmer server

# Deploy an agent from YAML
stigmer apply -f agent.yaml

# Run it
stigmer run support-bot "How do I reset my password?"

# Shell script (macOS/Linux)
curl -fsSL https://raw.githubusercontent.com/stigmer/stigmer/main/scripts/install.sh | bash

# From source
git clone https://github.com/stigmer/stigmer.git
cd stigmer && make setup && npm install && make local

What is Stigmer?

Stigmer turns domain knowledge and tools into AI agents you can call from any application.

• Skills — Teach agents your domain. Upload versioned knowledge and the agent answers with expertise instead of generic responses.
• MCP Servers — Give agents tools. Connect to your systems via the Model Context Protocol. Agents discover available tools and Stigmer handles execution sandboxing.
• Approval flows — Set rules for human oversight. Define which actions need approval before the agent proceeds. Executions are durable — they wait without losing state.

Every capability is exposed via gRPC with public protobuf contracts. Generate type-safe clients in Go, Python, Java, TypeScript, or Rust.

Core Concepts

Agents

An Agent has instructions, optional MCP servers for tool access, and optional model configuration.

apiVersion: agentic.stigmer.ai/v1
kind: Agent
metadata:
  name: support-bot
spec:
  instructions: |
    You are a helpful customer support agent.
    Answer questions politely and accurately.
    Check GitHub issues for known problems.
  mcp_server_usages:
    - mcp_server_ref:
        kind: mcp_server
        slug: github
    - mcp_server_ref:
        kind: mcp_server
        slug: filesystem

stigmer apply -f agent.yaml
stigmer run support-bot "What's the status of issue #42?"

Workflows

Multi-step automations that chain HTTP calls, agent calls, variable assignments, conditionals, and loops.

apiVersion: agentic.stigmer.ai/v1
kind: Workflow
metadata:
  name: hello-world
spec:
  tasks:
    - name: set-greeting
      kind: set_vars
      task_config:
        variables:
          greeting: "Hello, World!"

Tasks support set_vars, http_call, agent_call, wait, and control flow via flow.then. See examples/workflows/ for patterns including multi-agent orchestration and conditional branching.

Skills

Versioned knowledge artifacts that agents use for domain expertise. A Skill is a directory with a SKILL.md file containing YAML frontmatter:

my-skill/
  SKILL.md          # Required: interface definition with YAML frontmatter
  tool.sh           # Optional: tool implementation
  README.md         # Optional: documentation

stigmer push                          # push skill from current directory
stigmer draft skill --name my-skill   # scaffold a new skill

MCP Servers

Stigmer uses the Model Context Protocol to give agents tool access. Agents can use any STDIO-based MCP server — npm packages (npx), Python packages (uvx), Go modules (go run), or Docker images.

Stigmer also ships its own MCP server that exposes platform resources to AI-powered IDEs:

stigmer mcp-server

See mcp-server/README.md for IDE configuration (Cursor, Claude Desktop, VS Code, Windsurf).

SDKs

The Go, TypeScript, Python, and Java SDKs provide typed API clients for all platform resources. The React SDK renders agent UIs — session composers, message threads, and approval views. The Ink SDK brings the same components to the terminal.

Local vs Cloud

Resource definitions are portable across both modes. The CLI talks to the same gRPC service interfaces regardless of backend.

Documentation

• Getting Started (Cloud) — Create your first agent in 5 minutes
• Getting Started (Local) — Run agents on your machine
• CLI Reference — Commands, flags, and examples
• SDK Reference — Go, TypeScript, Python, Java, React, and Ink
• Core Concepts — Agents, Skills, Workflows, and how they fit together
• Examples — Sample agents, workflows, and skills

Development

Prerequisites

• Go 1.25+
• Python 3.11+ with Poetry
• Node.js 22+
• Git, Make

Building from Source

git clone https://github.com/stigmer/stigmer.git
cd stigmer

make setup     # Install Go and Python dependencies
npm install    # Install Node.js dependencies
make local     # Build the local stigmer-server (the CLI runs from @stigmer/cli)
make test      # Run tests

Contributing

We welcome contributions. See CONTRIBUTING.md for guidelines.

• GitHub Issues — Bug reports and feature requests
• Discord — Community chat

License

Apache License 2.0. See LICENSE.