# KohakuTerrarium

> KohakuTerrarium is a general-purpose AI agent framework and batteries-included app for building, running, and composing self-contained agents and multi-agent teams, with built-in tools, sub-agents, pe

- **URL**: https://www.freshcrate.ai/projects/KohakuTerrarium
- **Author**: Kohaku-Lab
- **Category**: Frameworks
- **Latest version**: `v2.0.0` (2026-05-29)
- **License**: NOASSERTION
- **Source**: https://github.com/Kohaku-Lab/KohakuTerrarium
- **Homepage**: https://terrarium.kohaku-lab.org/
- **Language**: Python
- **GitHub**: 208 stars, 24 forks
- **Registry**: github (`Kohaku-Lab/KohakuTerrarium`)
- **Tags**: `agent`, `agentic-framework`, `llm`, `python`

## Description

KohakuTerrarium is a general-purpose AI agent framework and batteries-included app for building, running, and composing self-contained agents and multi-agent teams, with built-in tools, sub-agents, persistent sessions, TUI, and web UI.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.0.0` | 2026-05-29 | High | # KohakuTerrarium 2.0.0  KohakuTerrarium started a little over a year ago as a way to build agents. With 2.0, it becomes a way to run them too.  This is a big release with the headline features you'd expect from a 2.0: a multi-machine runtime, a real package marketplace, optional accounts and authentication, a desktop app that updates itself, and the first Android build. But the change we care about most is quieter. After a year of figuring out what this project actually is, the design final |
| `v2.0.0.dev4` | 2026-05-18 | High | **Full Changelog**: https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v2.0.0.dev3...v2.0.0.dev4 |
| `v1.4.0` | 2026-05-11 | High | # KohakuTerrarium v1.4.0  KohakuTerrarium v1.4.0 is a major runtime and dashboard release. It introduces a typed interactive output bus, runtime module configuration, built-in policy plugins, a dynamic Terrarium graph tool surface, a unified session/graph API, and a new macro-shell web workspace with a visual runtime graph editor.  Full changelog: [`v1.3.0...v1.4.0`](https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v1.3.0...v1.4.0)  ## Highlights  ### Typed output bus and interactiv |
| `v1.4.0` | 2026-05-11 | Medium | # KohakuTerrarium v1.4.0  KohakuTerrarium v1.4.0 is a major runtime and dashboard release. It introduces a typed interactive output bus, runtime module configuration, built-in policy plugins, a dynamic Terrarium graph tool surface, a unified session/graph API, and a new macro-shell web workspace with a visual runtime graph editor.  Full changelog: [`v1.3.0...v1.4.0`](https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v1.3.0...v1.4.0)  ## Highlights  ### Typed output bus and interactiv |
| `v1.4.0` | 2026-05-11 | Medium | # KohakuTerrarium v1.4.0  KohakuTerrarium v1.4.0 is a major runtime and dashboard release. It introduces a typed interactive output bus, runtime module configuration, built-in policy plugins, a dynamic Terrarium graph tool surface, a unified session/graph API, and a new macro-shell web workspace with a visual runtime graph editor.  Full changelog: [`v1.3.0...v1.4.0`](https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v1.3.0...v1.4.0)  ## Highlights  ### Typed output bus and interactiv |
| `v1.4.0` | 2026-05-11 | Medium | # KohakuTerrarium v1.4.0  KohakuTerrarium v1.4.0 is a major runtime and dashboard release. It introduces a typed interactive output bus, runtime module configuration, built-in policy plugins, a dynamic Terrarium graph tool surface, a unified session/graph API, and a new macro-shell web workspace with a visual runtime graph editor.  Full changelog: [`v1.3.0...v1.4.0`](https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v1.3.0...v1.4.0)  ## Highlights  ### Typed output bus and interactiv |
| `v1.4.0` | 2026-05-11 | Medium | # KohakuTerrarium v1.4.0  KohakuTerrarium v1.4.0 is a major runtime and dashboard release. It introduces a typed interactive output bus, runtime module configuration, built-in policy plugins, a dynamic Terrarium graph tool surface, a unified session/graph API, and a new macro-shell web workspace with a visual runtime graph editor.  Full changelog: [`v1.3.0...v1.4.0`](https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v1.3.0...v1.4.0)  ## Highlights  ### Typed output bus and interactiv |
| `v1.4.0` | 2026-05-11 | Medium | # KohakuTerrarium v1.4.0  KohakuTerrarium v1.4.0 is a major runtime and dashboard release. It introduces a typed interactive output bus, runtime module configuration, built-in policy plugins, a dynamic Terrarium graph tool surface, a unified session/graph API, and a new macro-shell web workspace with a visual runtime graph editor.  Full changelog: [`v1.3.0...v1.4.0`](https://github.com/Kohaku-Lab/KohakuTerrarium/compare/v1.3.0...v1.4.0)  ## Highlights  ### Typed output bus and interactiv |
| `v1.3.0` | 2026-04-30 | High | # KohakuTerrarium v1.3.0 Release Notes  Release date: 2026-04-30  v1.3.0 is the largest KohakuTerrarium release so far. It promotes the new runtime hierarchy to the public API, adds Studio as the management layer above Terrarium, hardens provider/session behavior, and refreshes the docs around the final v1.3 configuration shapes.  Full comparison: `v1.2.0...v1.3.0`  ## Highlights  ### New public hierarchy: Studio → Terrarium → Creature  The framework is now documented and exposed |
| `v1.2.0` | 2026-04-25 | High | # KohakuTerrarium 1.2.0 — Release Notes  KohakuTerrarium 1.2.0 is a major feature release focused on two themes:  - turning sessions into a first-class, replayable, branchable system - expanding the framework surface around Studio, skills, package extensions, and model/runtime ergonomics  If 1.1.0 made the framework feel much better to use day-to-day, 1.2.0 makes it much more capable as a platform.  This release introduces session format evolution, replayable event-log history, in-sessi |

## Dependency audit

- **Score**: 77/100
- **Total deps**: 27
- **Resolved**: 15
- **Unresolved**: 12
- **License conflicts**: 0
- **Warnings**: 7
- **Scanned**: 2026-05-04

## Citation

- HTML: https://www.freshcrate.ai/projects/KohakuTerrarium
- Markdown: https://www.freshcrate.ai/projects/KohakuTerrarium.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/KohakuTerrarium/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._