navi-1

Модульная агентная система с REST API и WebSocket.

Запуск

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

cp .env.example .env  # при необходимости настрой

uvicorn navi.main:app --reload

API доступно по адресу http://localhost:8000.
Swagger UI: http://localhost:8000/docs

Быстрый старт (REST)

# 1. Создать сессию с профилем "secretary"
curl -X POST http://localhost:8000/sessions \
  -H "Content-Type: application/json" \
  -d '{"profile_id": "secretary"}'

# 2. Отправить сообщение (замени <session_id>)
curl -X POST http://localhost:8000/sessions/<session_id>/messages \
  -H "Content-Type: application/json" \
  -d '{"content": "Найди последние новости про Python 3.13"}'

WebSocket

ws://localhost:8000/ws/sessions/<session_id>

Клиент отправляет: {"type": "message", "content": "..."}
Сервер стримит: stream_start → tool_call* → stream_delta* → stream_end

Структура

navi/
├── main.py            # FastAPI app
├── config.py          # настройки через .env
├── exceptions.py      # доменные исключения
├── llm/               # LLM бекенды (ollama, openai stub)
├── tools/             # инструменты (web_search, filesystem, http, code, terminal)
├── profiles/          # профили агентов (smart_home, server_admin, secretary)
├── core/              # агент, реестры, сессии
└── api/               # роуты и WebSocket

Профили

Расширение

Новый профиль — создай navi/profiles/my_profile.py, добавь в ALL_PROFILES в __init__.py.

Новый инструмент — реализуй Tool из navi/tools/base.py, зарегистрируй в navi/core/registry.py.

Новый LLM бекенд — реализуй LLMBackend из navi/llm/base.py, зарегистрируй в navi/core/registry.py.