TrifonAI — локальная ИИ-платформа

01 · Философия

Два принципа, из которых следует всё остальное

ПРИНЦИП 01 «Интеллект, память и инструменты принадлежат платформе, а не модели.»

ПРИНЦИП 02 «Полная локальность. Единственное исключение — web_search.»

Модель — сменная деталь: сегодня qwen3:8b через Ollama, завтра любая другая. Долговременная память, характер и набор инструментов живут в коде и в базе, а не в весах модели. Заменить движок — не значит потерять ассистента.

02 · Хронология

Как проект рос

Две недели: от структуры папок до приложения в Dock.

до 10.07

Начальная архитектура: main.py, models/qwen.py

10.07

Память: SQLite + факты (core/assistant.py)

10.07

Cursor → Claude Code (лимит free-плана)

10.07

Личность: personality/system.md

12–25.07

Инструменты: 3 → 6 → 10

13.07

Планировщик: задачи и напоминания

13.07 ★

Исходный план закрыт полностью — веха

18.07

Обслуживание: v0.4 → v1.0

23–25.07

Веб-интерфейс: FastAPI + SSE

25.07

Запуск одной иконкой: TrifonAI.app

03 · Архитектура

Слои платформы

Клиенты взаимозаменяемы; ядро одно.

КЛИЕНТЫ

main.pyтерминал

ui/server.pyFastAPI + SSE

ЯДРО →

core/assistant.pyоркестрация

core/text · confirmчистка · подтверждение

СЛОИ ПЛАТФОРМЫ →

tools/10 инструментов

memory/диалоги · факты · задачи

personality/system.md

ВНЕШНИЕ РЕСУРСЫ →

SQLitetrifonai.db

Ollamaqwen3:8b

DuckDuckGoединственный выход в сеть

Рис. 1 — Слои платформы. Клиенты взаимозаменяемы; ядро одно.

Карта файлов

ПУТЬ	ОТВЕТСТВЕННОСТЬ
main.py	Терминальная версия — тонкий UI-цикл
core/assistant.py	Класс Assistant: оркестрация модели, памяти и инструментов
core/text.py	clean_model_output() — чистка ANSI-кодов Ollama
core/memory_evaluator.py	Извлечение фактов и смысловая дедупликация через модель
core/reminders.py	Показ актуальных напоминаний при старте
core/confirm.py	Абстракция подтверждения записи: терминал и веб
core/version.py	Единый источник версии (v1.2)
memory/database.py	SQLite: таблицы conversations, facts, tasks
models/qwen.py	Вызов Ollama; поиск бинарника по PATH с фолбэками
tools/registry.py	Реестр инструментов и протокол вызова
personality/system.md	Характер, идентичность, правила работы с памятью
ui/static/index.html	Весь веб-фронтенд одним файлом
scripts/*.sh	Запуск и остановка веб-версии, сборка .app
CLAUDE.md	Контекст проекта для Claude Code

04 · Инструменты

Десять инструментов

Момент, когда ассистент перестал быть говорящей головой.

ИНСТРУМЕНТ	МОДУЛЬ	ЧТО ДЕЛАЕТ
list_files	tools/basic.py	Содержимое папки
read_file	tools/basic.py	Чтение файла
write_file	tools/basic.py	Запись файла — только после подтверждения человеком
search_files	tools/basic.py	Поиск по файлам
recall_memory	tools/basic.py	Доступ к собственной памяти — фактам и истории
add_task	tools/tasks.py	Новая задача или напоминание
list_tasks	tools/tasks.py	Список активных задач
complete_task	tools/tasks.py	Закрыть задачу
complete_all_tasks	tools/tasks.py	Батч-закрытие — обход слабости модели в длинных цепочках
web_search	tools/web.py	Поиск в интернете через ddgs (DuckDuckGo)

get_current_time был одиннадцатым и удалён осознанно: текущее время подаётся в контекст всегда, отдельный вызов оказался лишним звеном и источником ошибок в датах.

05 · Инженерные истории

Баги, где симптом врал о причине

Четыре случая, где путь от симптома до причины был неочевиден.

3.1 · ANSI escape-коды Ollama в сохранённом тексте

СИМПТОМ: В базе и в интерфейсе в тексте ответов попадался мусор вокруг нормальных слов.
ПРИЧИНА: Ollama в CLI-режиме подмешивает ANSI escape-коды. В терминале мусор был невиден — терминал его исполнял, а не печатал. В базу он попадал как есть.
РЕШЕНИЕ: Отдельный слой очистки — core/text.py, функция clean_model_output(). Единая точка: всё от модели проходит через неё.

3.2 · SQLite LOWER() не работает с кириллицей

СИМПТОМ: Поиск по памяти находил не всё: запрос «москва» не находил факт со словом «Москва».
ПРИЧИНА: Встроенный LOWER() в SQLite работает только с ASCII. SQL был корректен; неверным было предположение о его семантике.
РЕШЕНИЕ: Приведение регистра перенесено в Python, где Unicode работает как ожидается — на стороне запроса, а не движка базы.

3.5 · macOS TCC: права привязаны к подписи процесса

СИМПТОМ: После сборки .app инструменты работы с файлами перестали видеть содержимое папок, хотя «Полный доступ к диску» был выдан.
ПРИЧИНА: TCC привязывает разрешения к подписи процесса, а не к папке .app. Обёртка и интерпретатор — разные субъекты. Право было выдано не тому, кто обращался к диску.
РЕШЕНИЕ: Разбираться с моделью безопасности системы, а не с кодом. Ни одной строкой Python это не лечилось.

3.7 · threading.local в пуле потоков Starlette

СИМПТОМ: События терялись: часть вызовов инструментов не доходила до браузера. Непредсказуемо — то доходили, то нет.
ПРИЧИНА: Канал событий хранился в threading.local. Starlette выполняет синхронный код в пуле потоков — код, публикующий событие, видел пустое хранилище вместо канала.
РЕШЕНИЕ: Отказ от привязки контекста к потоку — контекст передаётся явно, по границе запроса. Симптом указывал на транспорт, причина была в модели исполнения фреймворка.

ещё 4 разобранных бага — в полной ретроспективе (PDF ниже).

06 · Ограничения

Честно о компромиссах

Маленькая модель не всегда держит стиль. qwen3:8b периодически нарушает инструкции из system.md. Цена локальности.
Не тянет длинные цепочки однотипных вызовов. Решение не в промпте, а в архитектуре: батч-инструменты вместо чейнинга.
Нет мультимодальности. Ассистент не видит изображения — только текст.
Несколько моделей одновременно — осознанно отложено. Архитектура готова, но задача не решает текущей боли.

07 · Что дальше

Toward a weak local Claude Code

Выполнение команд в терминале — с тем же принципом обязательного подтверждения, что уже отработан на записи файлов.
Точечное редактирование файлов — правка фрагмента, а не перезапись файла целиком.
Более длинный агентский цикл — способность держать многошаговую задачу, а не один вызов инструмента за ход.

Платформа к этому готова архитектурно: реестр инструментов расширяется одним файлом, подтверждение абстрагировано под два интерфейса, память и личность от модели не зависят.

Два принципа, из которых следует всё остальное

Как проект рос

Слои платформы

Десять инструментов

Баги, где симптом врал о причине

Честно о компромиссах

Toward a weak local Claude Code

Скачать полную ретроспективу