Metadata-Version: 2.4
Name: chinchill
Version: 0.1.0
Summary: CLI for the Chinchill agent framework — scaffold a durable AI agent project with `chinchill init`
Author-email: Chinchill AI <patrick@chinchill.ai>
License: Apache-2.0
Project-URL: Homepage, https://github.com/Chinchill-AI/chinchill-api
Keywords: ai,agents,agent-framework,llm,scaffold
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# chinchill

The CLI for **[Chinchill](https://github.com/Chinchill-AI/chinchill-api)** — an
open framework for building durable AI agents your team can talk to everywhere
they already work (Slack, Microsoft Teams, GitHub, MCP clients, or plain HTTP),
with persistent workspaces, file-based skills, sandboxed code execution, and
human-in-the-loop approvals built in.

## Scaffold an agent project

```bash
uvx chinchill init my-agent
cd my-agent
docker compose up          # then open http://127.0.0.1:8080/dev/chat-ui
```

`chinchill init` emits a small **pack project you own** — the agent's persona
as editable Markdown, a `tools/` folder where every public Python function
becomes an agent tool, a `connections/` folder that compiles OpenAPI specs into
tools, and a docker-compose file that runs the framework as a container image
behind it. No dependencies beyond the standard library.

Other subcommands (`chinchill eval`, for running behavioral eval datasets
against your agent) run inside a framework environment — see the
[framework repository](https://github.com/Chinchill-AI/chinchill-api) and its
[CLI reference](https://github.com/Chinchill-AI/chinchill-api/blob/main/docs/reference/cli.md).

Licensed under Apache-2.0.
