What is tiri-agent?

Tiri Agent is a personal AI assistant that runs on your own machine rather than in someone else's cloud. It is built on top of a separate core project called agent-runtime, and this repository turns that core into something you can actually use day to day: a command line chat, a set of backend APIs, and a web interface built with Next.js and React. The project keeps its data local. It stores chat sessions, message history, settings, and other records in a SQLite database on your own computer, defaulting to a folder called .tiri in your home directory. You configure which AI model it talks to by setting a handful of environment variables, such as which provider API to use, the model name, and an API key, then start it either as a command line chat tool or as a running server with both a backend and a web page. Beyond chat, Tiri can act on your behalf using sandbox tools that read files, write files, list files, and run shell commands. These can run directly on your machine or inside a Docker container for extra isolation, with one container reused per chat session so state persists across a conversation. It also supports connecting to messaging platforms. The project includes adapters for Telegram, Weixin or WeChat, and Feishu or Lark, so the assistant can send and receive messages through those channels, not just through the local CLI or web shell. Setting it up involves creating a Python virtual environment, installing both this repository and its companion agent-runtime package, and configuring your chosen AI provider's credentials before running the CLI or server commands. The project is aimed at developers comfortable working with Python and command-line tools rather than a plug-and-play consumer app. Tiri Agent is released under the GNU Affero General Public License version 3.