Version 0.1.0
Cognitive Helper for Adaptive Response and Logical Intelligent Execution
C.H.A.R.L.I.E. is a lightweight, command-line-centered AI agent and assistant in Python that can be run locally offline (requires model installation) or online using a public API. It is beginner-friendly and highly customizable, and can be easily integrated into other projects.
By Morpheus
charlie is a Python package for building a conversational AI agent that can:
- send chat requests to an OpenAI-compatible endpoint
- register tools the model can call during a conversation
- register runtime context providers and inject their output into the prompt
- run an interactive and customizable terminal chat loop
The package is structured around an Agent class, a CLI class, a tool
registry, a context registry, and a small set of built-in toolsets for text,
math, datetime, and structured-data operations.
- User Guide: docs/user_guide.md
- Go to the repository homepage on GitHub
- Click on Releases (found on the right column on Desktop)
- Scroll to the latest release and select one of the download links (ZIP recommended) under 'Assets'
- Open the downloaded archive file on your local machine
Special thanks to @indently for his YouTube tutorial series, "Build a Local AI Agent in Python", which helped get this project started. Check out his YouTube chanel here.
This project is licensed under the MIT License.