explaingit

tinyhumansai/tinyagents

Analysis updated 2026-05-18

23RustAudience · developerComplexity · 4/5LicenseSetup · moderate

TLDR

A Rust framework for building AI agents that can call themselves and other agents recursively to handle very large amounts of context.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build an AI agent system where agents call other agents as tools to divide up complex tasks.

USE CASE 2

Process very large documents or contexts by breaking them into pieces the model explores step by step.

USE CASE 3

Create durable, resumable AI workflows that can pause and continue later without losing progress.

USE CASE 4

Track usage and cost across many nested AI model calls in one system.

What is it built with?

Rust

How does it compare?

tinyhumansai/tinyagentsadindazu/tangoaudiobigmacfive/turbo-graph
Stars232323
LanguageRustRustRust
Setup difficultymoderatemoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires familiarity with Rust and access to a supported AI model provider.

In plain English

TinyAgents is a Rust toolkit for building AI agents, built around an idea called a recursive language model, or RLM. Most tools for building AI agents try to stuff everything the model needs into one growing block of text and hope the model can handle it. TinyAgents takes a different approach: instead of loading all the information at once, a long piece of text is treated like a small environment the model can explore step by step, breaking it into pieces and calling itself, or smaller helper models, on those pieces. The goal is to let an AI system work with far more information than would normally fit in its memory at one time, while keeping the process organized and inspectable. The project is inspired by a 2025 research paper on recursive language models from MIT, and it brings that idea into a working Rust system rather than just following the research results exactly. In TinyAgents, one AI agent can call another agent as if it were a simple tool, so a chain of agents working together looks like a series of function calls. It also includes a graph system, similar in spirit to tools like LangGraph, where each step in a workflow is a node that can pass control to the next step, pause, resume later, or even contain another whole workflow inside it. TinyAgents provides two small custom languages for describing this behavior: one is a fixed blueprint format for laying out a workflow in advance, and the other is an interactive command style where the AI model can write, run, and inspect small programs on the fly. The system also tracks how deep the calls go, keeps a record of costs and usage across all these nested calls, and can pause and resume long-running processes without losing progress. It works with multiple AI model providers rather than locking a user into just one. The README says the project does not try to reproduce the exact benchmark numbers from the original research paper. It is licensed under GPLv3, meaning any software built using it and distributed to others must also share its source code under the same license.

Copy-paste prompts

Prompt 1
Help me set up a basic TinyAgents project in Rust using the harness and graph runtime.
Prompt 2
Explain how sub-agents work as tools in TinyAgents and how to write one.
Prompt 3
Show me how to write a simple .rag blueprint workflow for TinyAgents.
Prompt 4
Walk me through the difference between the .rag and .ragsh languages in TinyAgents.

Frequently asked questions

What is tinyagents?

A Rust framework for building AI agents that can call themselves and other agents recursively to handle very large amounts of context.

What language is tinyagents written in?

Mainly Rust. The stack also includes Rust.

How hard is tinyagents to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is tinyagents for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.