{"id":42894997,"url":"https://github.com/stigmer/stigmer","last_synced_at":"2026-07-14T08:01:27.809Z","repository":{"id":333213510,"uuid":"1136576010","full_name":"stigmer/stigmer","owner":"stigmer","description":"Build AI agents and workflows with zero infrastructure","archived":false,"fork":false,"pushed_at":"2026-07-12T14:08:11.000Z","size":317668,"stargazers_count":7,"open_issues_count":19,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-12T14:12:45.508Z","etag":null,"topics":["agents","ai","automation","golang","mcp","open-source","python","sqlite","workflow"],"latest_commit_sha":null,"homepage":"https://stigmer.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stigmer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-17T23:54:27.000Z","updated_at":"2026-07-12T13:49:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"9dcfab27-d1c4-494d-ad3f-a114fac26345","html_url":"https://github.com/stigmer/stigmer","commit_stats":null,"previous_names":["stigmer/stigmer"],"tags_count":408,"template":false,"template_full_name":null,"purl":"pkg:github/stigmer/stigmer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stigmer%2Fstigmer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stigmer%2Fstigmer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stigmer%2Fstigmer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stigmer%2Fstigmer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stigmer","download_url":"https://codeload.github.com/stigmer/stigmer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stigmer%2Fstigmer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35445243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-14T02:00:06.603Z","response_time":114,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","automation","golang","mcp","open-source","python","sqlite","workflow"],"created_at":"2026-01-30T15:05:50.031Z","updated_at":"2026-07-14T08:01:27.799Z","avatar_url":"https://github.com/stigmer.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://stigmer.ai\"\u003e\n    \u003cimg src=\"docs/banner_dark.png\" alt=\"Stigmer — Open-source AI agent platform\" width=\"100%\" height=\"auto\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n# Stigmer\n\n**An open-source AI agent platform.**\n\nDefine agents in YAML, deploy with one command, call from any app via API.\nRun locally with SQLite or connect to Stigmer Cloud for production.\nBring your own LLM — Anthropic, OpenAI, or Ollama.\n\n[![License](https://img.shields.io/github/license/stigmer/stigmer)](LICENSE)\n[![Discord](https://img.shields.io/badge/Discord-community-5865F2?logo=discord\u0026logoColor=white)](https://discord.com/invite/EtANnfsJ8B)\n[![GitHub stars](https://img.shields.io/github/stars/stigmer/stigmer?style=flat)](https://github.com/stigmer/stigmer/stargazers)\n\n## Quick Start\n\n```bash\n# Install\nbrew install stigmer/tap/stigmer\n\n# Start the server (interactive LLM setup on first run)\nstigmer server\n\n# Deploy an agent from YAML\nstigmer apply -f agent.yaml\n\n# Run it\nstigmer run support-bot \"How do I reset my password?\"\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eOther install methods\u003c/summary\u003e\n\n```bash\n# Shell script (macOS/Linux)\ncurl -fsSL https://raw.githubusercontent.com/stigmer/stigmer/main/scripts/install.sh | bash\n\n# From source\ngit clone https://github.com/stigmer/stigmer.git\ncd stigmer \u0026\u0026 make setup \u0026\u0026 npm install \u0026\u0026 make local\n```\n\n\u003c/details\u003e\n\n## What is Stigmer?\n\nStigmer turns domain knowledge and tools into AI agents you can call from any application.\n\n- **Skills** — Teach agents your domain. Upload versioned knowledge and the agent answers with expertise instead of generic responses.\n- **MCP Servers** — Give agents tools. Connect to your systems via the [Model Context Protocol](https://modelcontextprotocol.io). Agents discover available tools and Stigmer handles execution sandboxing.\n- **Approval flows** — Set rules for human oversight. Define which actions need approval before the agent proceeds. Executions are durable — they wait without losing state.\n\nEvery capability is exposed via gRPC with public protobuf contracts. Generate type-safe clients in Go, Python, Java, TypeScript, or Rust.\n\n## Core Concepts\n\n### Agents\n\nAn Agent has instructions, optional MCP servers for tool access, and optional model configuration.\n\n```yaml\napiVersion: agentic.stigmer.ai/v1\nkind: Agent\nmetadata:\n  name: support-bot\nspec:\n  instructions: |\n    You are a helpful customer support agent.\n    Answer questions politely and accurately.\n    Check GitHub issues for known problems.\n  mcp_server_usages:\n    - mcp_server_ref:\n        kind: mcp_server\n        slug: github\n    - mcp_server_ref:\n        kind: mcp_server\n        slug: filesystem\n```\n\n```bash\nstigmer apply -f agent.yaml\nstigmer run support-bot \"What's the status of issue #42?\"\n```\n\n### Workflows\n\nMulti-step automations that chain HTTP calls, agent calls, variable assignments, conditionals, and loops.\n\n```yaml\napiVersion: agentic.stigmer.ai/v1\nkind: Workflow\nmetadata:\n  name: hello-world\nspec:\n  tasks:\n    - name: set-greeting\n      kind: set_vars\n      task_config:\n        variables:\n          greeting: \"Hello, World!\"\n```\n\nTasks support `set_vars`, `http_call`, `agent_call`, `wait`, and control flow via `flow.then`. See [examples/workflows/](examples/workflows/) for patterns including multi-agent orchestration and conditional branching.\n\n### Skills\n\nVersioned knowledge artifacts that agents use for domain expertise. A Skill is a directory with a `SKILL.md` file containing YAML frontmatter:\n\n```\nmy-skill/\n  SKILL.md          # Required: interface definition with YAML frontmatter\n  tool.sh           # Optional: tool implementation\n  README.md         # Optional: documentation\n```\n\n```bash\nstigmer push                          # push skill from current directory\nstigmer draft skill --name my-skill   # scaffold a new skill\n```\n\n### MCP Servers\n\nStigmer uses the [Model Context Protocol](https://modelcontextprotocol.io) 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.\n\nStigmer also ships its own MCP server that exposes platform resources to AI-powered IDEs:\n\n```bash\nstigmer mcp-server\n```\n\nSee [mcp-server/README.md](mcp-server/README.md) for IDE configuration (Cursor, Claude Desktop, VS Code, Windsurf).\n\n## SDKs\n\n| SDK | Install | Reference |\n|-----|---------|-----------|\n| **Go** | `go get github.com/stigmer/stigmer/sdk/go/v3` | [Reference](https://stigmer.ai/docs/sdk/go) |\n| **TypeScript** | `npm install @stigmer/sdk` | [Reference](https://stigmer.ai/docs/sdk/typescript) |\n| **Python** | `pip install stigmer` | [Reference](https://stigmer.ai/docs/sdk/python) |\n| **Java** | Maven: `ai.stigmer:stigmer-java` | [Reference](https://stigmer.ai/docs/sdk/java) |\n| **React** | `npm install @stigmer/react` | [Reference](https://stigmer.ai/docs/sdk/react) |\n| **Ink** | `npm install @stigmer/ink` | [Reference](https://stigmer.ai/docs/sdk/ink) |\n\nThe 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.\n\n## Local vs Cloud\n\n| | Local Mode (Open Source) | Cloud Mode (Stigmer Cloud) |\n|---|---|---|\n| **Start with** | `stigmer server` | `stigmer config backend set cloud` |\n| **Storage** | SQLite (`~/.stigmer/stigmer.db`) | Distributed (managed) |\n| **Users** | Single implicit user | Organizations, teams, IAM |\n| **LLM** | Anthropic, OpenAI, or Ollama (your choice) | Configurable |\n| **Best for** | Development, personal projects, air-gapped environments | Team collaboration, production, governance |\n\nResource definitions are portable across both modes. The CLI talks to the same gRPC service interfaces regardless of backend.\n\n## Documentation\n\n- [Getting Started (Cloud)](https://stigmer.ai/docs/getting-started/quickstart) — Create your first agent in 5 minutes\n- [Getting Started (Local)](https://stigmer.ai/docs/getting-started/local) — Run agents on your machine\n- [CLI Reference](https://stigmer.ai/docs/cli) — Commands, flags, and examples\n- [SDK Reference](https://stigmer.ai/docs/sdk) — Go, TypeScript, Python, Java, React, and Ink\n- [Core Concepts](https://stigmer.ai/docs/concepts/what-is-stigmer) — Agents, Skills, Workflows, and how they fit together\n- [Examples](examples/) — Sample agents, workflows, and skills\n\n## Development\n\n### Prerequisites\n\n- Go 1.25+\n- Python 3.11+ with [Poetry](https://python-poetry.org/)\n- Node.js 22+\n- Git, Make\n\n### Building from Source\n\n```bash\ngit clone https://github.com/stigmer/stigmer.git\ncd stigmer\n\nmake setup     # Install Go and Python dependencies\nnpm install    # Install Node.js dependencies\nmake local     # Build the local stigmer-server (the CLI runs from @stigmer/cli)\nmake test      # Run tests\n```\n\n## Contributing\n\nWe welcome contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n- [GitHub Issues](https://github.com/stigmer/stigmer/issues) — Bug reports and feature requests\n- [Discord](https://discord.com/invite/EtANnfsJ8B) — Community chat\n\n## License\n\nApache License 2.0. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstigmer%2Fstigmer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstigmer%2Fstigmer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstigmer%2Fstigmer/lists"}