Our take
Newless than six months old and changing fast- Activity
- 67
- Community
- 11
- Issues
- 95
- Pull requests
- 86
+1 stars in the last 30 days
- Merges more pull requests than 99% of the projects we track
- Closes issues faster than 82% of the projects we track
- Fewer contributors than 86% of the projects we track
This is a broad, actively changing Go agent platform, but its maintenance-only policy and extreme contributor concentration make its future direction a significant adoption consideration.
Good fit if
- You want YAML-defined agent workflows executed by a shared Go runtime.
- You can work with the repository's existing applications, catalog and Mage-based build setup.
- You are comfortable with BSD-3-Clause licensing and a project that currently accepts bug fixes only.
Look elsewhere if
- You need a project that is open to ongoing feature development or roadmap contributions.
- Your team cannot manage the risk of a project where nearly all contribution activity comes from one person.
- You need an agent framework built around a particular model provider or engine, which this repository does not identify as its foundation.
All health signals
| Last commit | 2026-10-22 (1 day ago) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 2 (latest ui-kit/v1.1.0, 2026-09-19) |
| Contributors | 2 (top contributor: 100% of commits) |
| Issues closed, last 90 days | 72+ (typically closed in 0 days) |
| Pull requests merged, last 90 days | 100+ (typically merged in 0 days) |
| Project age | 4 months |
Checked on 2026-10-24 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
5Forks
1Change since Nov 9, 2026: 0 stars·0 forks
Overview
Nokia Bell Labs' declarative-agents is a Go runtime for tool-augmented LLM agents defined by YAML profiles. Profiles specify tools, states, transitions, signals and budgets, so teams can change an agent's workflow as configuration instead of binding it to code that must be rebuilt.
The repository also includes reusable agent and tool blocks, example applications, an application DSL specification, and a white paper describing eleven design patterns. It is intended for developers building configurable agent systems, especially those who want a shared runtime for multiple agent workflows.
Key Features
- Loads agent behavior from YAML profiles and executes it with one Go runtime.
- Defines agent states, transitions, tools, signals and budgets in configuration.
- Includes a standard tool library, profile validation and command-line runtime.
- Provides reusable catalog blocks and composed applications, including a coding agent and a browser-facing chatbot.
- Documents an application DSL with numbered requirements and acceptance evidence.
- Includes a white paper on eleven patterns for dependable declarative agents.
- Uses Mage targets for building, testing, auditing and packaging repository modules.
Use Cases
- Agent developers can adjust workflow states and transitions without producing a new runtime binary for each change.
- Platform teams can maintain reusable agent and tool definitions in a shared catalog and compose them into applications.
- Teams building coding agents can use the included planner, executor and critic application as a starting point.
- Researchers and engineering teams can consult the design-pattern paper and DSL specification when establishing agent conventions.
What you need
Detected in the repository
- Go (main language on GitHub)
License in plain words
BSD-3-Clausepermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice; the authors' names cannot endorse your product
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
For the packaged documentation-curator application, install Go and Mage, then run:
cd applications/agent-architecture
mage run
See the repository README for direct profile execution and module-specific setup.
Alternatives
- deepagents: Deep Agents is a Python harness with built-in planning and delegation, while declarative-agents defines workflows in YAML and runs them in Go.
- rig: Rig is a Rust library for composing LLM applications and agent workflows, while declarative-agents uses YAML profiles with a Go runtime.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| declarative-agents | Go | BSD-3-Clause | 5 | New |
| deepagents | Python | MIT | 29.9k | Active |
| rig | Rust | MIT | 8.8k | Active |
Considerations
The repository is in maintenance mode and accepts bug fixes only. Although it is new and has seen rapid recent development and releases, the measured contributor base is small and contribution activity is overwhelmingly concentrated in one person. That creates maintainer-continuity risk for a project spanning a runtime, specifications and several applications. The repository is licensed under BSD-3-Clause; review its terms for your distribution and use.
Found this useful?
Share it with someone who would like declarative-agents.