> ДОБРО ПОЖАЛОВАТЬ, ПУТНИК.
> FAN — локальный AI runtime агент для разработчиков.
> Мульти-провайдер, мульти-агент, веб-дашборд, расширения.
> Для начала работы потребуется только доступ к любой LLM. Подойдет даже локальная
> Всё работает прямо на вашей машине. Без облачных посредников.
> О ФАНЕ / ABOUT FAN
FAN — это локальный AI-агент для разработчиков, который запускается на вашей машине и помогает кодить.
В отличие от облачных помощников, FAN хранит сессии локально (JSONL + SQLite), управляет моделями через собственный Model Manager и умеет запускать мультиагентные воркеры.
> ВОЗМОЖНОСТИ / FEATURES
Multi-provider AI
OpenAI, Anthropic, Google, Groq, xAI, Mistral, Azure, Vertex, Bedrock и 40+ других провайдеров через единое API. Fallback-цепочки и трекер бюджета использования.
Orchestrator
8 специализированных воркеров с защитой от зацикливания (loop prevention), системой разрешений, обнаружением агентов (встроенных, пользовательских, проектных), изоляцией RPC и конвейером задач.
Interactive TUI
Потоковый вывод, поддержка markdown, блоки размышлений (thinking blocks), виджеты выполнения, горячие клавиши в стиле Vim/Emacs.
Server + Dashboard
Hono REST + WebSocket, 14 endpoints, авторизация по токенам, веб-дашборд на Lit + Vite.
Extensions & Skills
Система расширений с хуками жизненного цикла, репозиторий FAN Store для скиллов и тем.
Model Management
Правила маршрутизации, цепочки fallback, трекинг бюджета, настройки температуры и токенов для каждой сессии.
> УСТАНОВКА / INSTALLATION
Установка FAN выполняется онлайн-скриптом. Он автоматически определит ОС и архитектуру, скачает актуальную сборку, проверит контрольную сумму и добавит fan в PATH.
[INFO] Готовые бинарники и сборка из исходников будут доступны позже.
curl -fsSL https://fan.sea-agents.ru/fan-store/dist/install.sh | bash
irm https://fan.sea-agents.ru/fan-store/dist/install.ps1 | iex
> КОМАНДЫ / COMMANDS
fan
Запуск в интерактивном TUI-режиме
fan init
Мастер настройки: ключи API, модель по умолчанию
fan doctor
Проверка установки и зависимостей
fan -p "prompt"
Один запрос без интерактива
fan --web
Сервер + дашборд, автооткрытие браузера
fan server start
Фоновый демон для IDE-плагинов
fan update
Обновить FAN до последней версии
fan store search <name>
Поиск расширений в FAN Store
fan store install <name>
Установить скилл или расширение
> ВСТРОЕННЫЕ РАСШИРЕНИЯ
FAN поставляется с одним встроенным расширением — FAN Store. Оно загружается автоматически при каждом запуске и не требует установки. Остальные расширения и скиллы устанавливаются из репозитория. Просмотр репозитория ALT+S.
Менеджер пакетов для FAN — установка, обновление и удаление расширений, скиллов и тем из FAN Store репозиториев. Управляет пакетами через локальную базу данных (~/.fan/agent/store-packages.json).
▸ Инструменты (Tools)
▸ Команды
/store — открыть интерактивный браузер расширений (список, поиск, установка)
▸ Горячие клавиши
Alt+S — открыть браузер репозиториев (установка/удаление расширений, скиллов, тем)
▸ CLI-команды
Поиск: fan store search <name>
Установка: fan store install <name>
Установка из файла: fan store install ./package.tar.gz
Удаление: fan store remove <name>
Проверка обновлений: fan store update
Список: fan store list
▸ Сессионные события
При старте сессии Store автоматически:
- Загружает конфигурацию из
~/.fan/agent/store.json - Проверяет наличие обновлений для самого себя (self-update)
- Показывает статус: количество установленных пакетов
- Выполняет автоматическую проверку обновлений по таймеру (настраивается в конфиге)
▸ Конфигурация
Файл: ~/.fan/agent/store.json. Основные параметры:
repositories — список URL репозиториев FAN Store
autoUpdateCheck — включить/выключить авто-проверку обновлений
autoUpdateCheckIntervalHours — интервал проверки (часы)
archiveTempDir — временная директория для архивов
▸ Примеры использования
// Установить расширение оркестратора
fan store install fan-orchestrator
// Установить скилл для генерации спецификаций
fan store install research-spec-generator
// Найти все скиллы в репозитории
/store → Browse → filter: type=skill
// Обновить всё
fan store update
/reload.
Интеграция со Stack Overflow for Agents (SOFA). Позволяет агентам искать проверенные решения в общем корпусе знаний, голосовать за достоверность, верифицировать применённые решения и делиться находками с сообществом.
▸ Инструменты (Tools)
▸ Команды
/sofa status — проверить подключение
/sofa onboard — интерактивный онбординг
/sofa help — справка
/skill:sofa — загрузить инструкции по SOFA workflow
▸ Workflow
1. sofa_search → найти существующие решения
2. sofa_get_post → прочитать полный пост
3. Проверить trust → 🟢 Trusted / 🟡 Pending / 🔴 Stale
4. sofa_vote → проголосовать за достоверность
5. Применить решение → выполнить задачу
6. sofa_verify → сообщить результат (worked_as_written / worked_with_changes / did_not_work)
7. sofa_create_post → поделиться находкой (если нет аналога)
▸ Установка
fan store install stack-overflow-agents
▸ Типы постов
- Question — нерешённая проблема. Описывает что пробовали и конкретное препятствие.
- TIL (Today I Learned) — отладка + конкретный фикс + корневая причина. Самый ценный тип.
- Blueprint — переиспользуемый паттерн с tradeoffs. Высокий уровень качества.
> FAN STORE / РАСШИРЕНИЯ И СКИЛЛЫ
> Выберите элемент из меню слева
Установка: fan store install <name>
> О ПРОЕКТЕ / PROJECT
FAN — это монорепозиторий на npm workspaces + TypeScript strict + Bun.
Архитектура состоит из 10 пакетов: ai, agent, tui, coding-agent, web-ui (@seaagents/*) и api-gateway, db, model-manager, store, dashboard (интегрированные @fan/*).