unixzii/little-agent

README preview

# little-agent

`little-agent` is a lightweight embedded agent framework (similar to Claude Code and OpenAI Codex). It supports multiple model providers and can be integrated with your apps easily.

![CLI Screenshot](./screenshot.png)

## Why another agent?

There are already many agent projects around the world, and they are valuable both for practical use and for study. However, I want to write my own agent — one that is simple, maintainable and embeddable. Instead of designing an overly complex mechanism, I prefer to keep this project KISS. The agent is essentially a simple loop: the model receives user input and may output tool-call requests. The agent executes tools and sends the results back to the model. The loop continues until there are no more tool-call requests. With this simple design, I want to continuously explore the model’s capabilities. And since the project is written in Rust and exports C APIs, I can integrate it into my other apps and add agentic features to them.

## Getting started

### Use as a library

It's recommended to use the `little-agent` crate, which provides some built-in tools and is ready to use. For more advanced use cases, you can also use the `core` crate, which enables finer-grained control over the agent.

`little-agent` also exports some C APIs. You can build it as a dynamic library, and link your apps against it. See [`include/little-agent.h`](./include/little-agent.h) for the interface.

For Rust APIs, run `cargo doc` to build the docs.

View full repository on GitHub →