あなた自身のAIアシスタント。 ノートパソコン 午後に読むことができます。

Tini — あらゆる背後にある4つの柱を示すローカルファーストのパーソナルアシスタント 深刻なエージェント:ハーネス・コンテキスト・ツール・ループ・メモリ・Eval/LLM-Ops よい部分を隠すフレームワーク無し。

• ローカル優先 メモリは1つのSQLiteファイルです。 お問い合わせ お問い合わせ お問い合わせ
• 記憶は英雄です。 セマンティック+エピソディカル+手続き — かどうかを決定するゲートで 覚えておいてください。what を保ちたいと判断するパスです。
• ループは~95行のプレーンPythonです。 それを通してステップ。 -見てみると思った。 ローカルダッシュボードは、ハーネスを流れるように、すべてのメッセージが点灯します。
• ** ビルトイン。** 決定的なテスト and LLM-as-judge, サイドバイサイド, リリースゲート付き.

シリーズからシステム設計ホワイトボード。 各ボックスはファイルにマップします。ホワイトボードのマップをコードに表示します。

▶ コードウォークスルーを見る — ループ、メモリの柱、楕円形、テレグラムのゲートウェイと「ティーニ」のウェイクワード、ライブ。

クイックスタート

実行したいだけ:

初めて設定するキーをお伝えします。 コードを読んでみたい** ( このリポジトリのポイントまたは貢献 — 代わりにそれをクローン:

Tini-agent

Your own AI assistant. On your laptop. In code you can read in an afternoon.

Meet Tini — a local-first personal assistant that shows the four pillars behind every serious agent: Harness · Context · Tools · Loop · Memory · Eval/LLM-Ops. No frameworks hiding the good parts.

• Local-first. Your memory is one SQLite file. Open it. Read it. It’s yours.
• Memory is the hero. Semantic + episodic + procedural — with a gate that decides whether to remember, and a pass that decides what to keep.
• The loop is ~95 lines of plain Python. Step through it.
• Watch it think. A local dashboard lights up every message as it flows through the harness.
• Eval built in. Deterministic tests and LLM-as-judge, side by side, with a release gate.

The system-design whiteboard from the series. Every box maps to a file — see the whiteboard maps to the code.

▶ Watch the code walkthrough — the loop, the memory pillars, the evals, the Telegram gateway and the “Tini” wake word, live.

Quickstart

Just want to run it:

pip install tini-agent
tini                                    # talk to your Tini in the terminal
tini dashboard                          # …or the browser cockpit → localhost:9000

It will tell you which key to set the first time. Want to read the code (the point of this repo) or contribute — clone it instead:

git clone https://github.com/tini-coder/tini-agent && cd tini-agent
uv venv && uv pip install -e .          # create the env + install the `tini` command
cp .env.example .env                    # pick a provider, paste ONE key
uv run tini                             # talk to your Tini in the terminal
uv run tini dashboard                   # …or the browser cockpit → localhost:9000

uv run tini … needs no venv activation. Three ways to run it:

tini and tini dashboard are two doors into the same Tini. The dashboard is a tiny web server on your machine — chat in the browser, that process runs the turn. Nothing leaves your laptop. Set TELEGRAM_BOT_TOKEN and it starts your bot too. (make dashboard works as well.)

Now try it. “Remember that Alex prefers morning meetings.” Quit. Restart. “Book a catch-up with Alex on Friday.” → it remembers, and books 9am. Your memory is one file: .tini/state.db.