Документация

Настройка AI-моделей, провайдеров и API-ключей

Полный справочник по ~/.andromity/config.toml, переменным окружения, моделям и настройкам конфиденциальности.

Andromity хранит пользовательские настройки, активные профили и учётные данные провайдеров в локальном файле конфигурации ~/.andromity/config.toml (или %APPDATA%\andromity\config.toml в Windows).

Этот файл автоматически инициализируется при первом запуске.


Пример config.toml

[default]
provider   = "anthropic"
model      = "claude-3-7-sonnet"
profile    = "builder"
permission_mode = "safe"
telemetry  = true              # Задайте false, чтобы отключить анонимные метрики

[[providers]]
name       = "anthropic"
type       = "anthropic"
api_key    = "sk-ant-api03-..."

[[providers]]
name       = "openai"
type       = "openai"
api_key    = "sk-proj-..."

[[providers]]
name       = "gemini"
type       = "google"
api_key    = "AIzaSy..."

[[providers]]
name       = "groq"
type       = "groq"
api_key    = "gsk_..."

[[providers]]
name       = "openrouter"
type       = "openrouter"
api_key    = "sk-or-v1-..."

[[providers]]
name       = "ollama"
type       = "ollama"
base_url   = "http://localhost:11434"

Поддерживаемые переменные окружения

Помимо config.toml, Andromity автоматически распознаёт стандартные переменные окружения провайдеров:

ПеременнаяПровайдерПример
ANTHROPIC_API_KEYAnthropicsk-ant-api03-...
OPENAI_API_KEYOpenAIsk-proj-...
GEMINI_API_KEYGoogle GeminiAIzaSy...
GROQ_API_KEYGroqgsk_...
OPENROUTER_API_KEYOpenRoutersk-or-v1-...
CEREBRAS_API_KEYCerebrascsk-...
MISTRAL_API_KEYMistral AI...
OLLAMA_HOSTOllama (локально)http://localhost:11434
DO_NOT_TRACKФлаг конфиденциальности1 (отключает всю телеметрию)

Управление ключами через команды чата

Вы можете просматривать и обновлять ключи, не редактируя файлы .toml вручную:

/keys

/keys set anthropic sk-ant-...
/keys set openai sk-proj-...
/keys set gemini AIzaSy...

Выбор модели и переключение на лету

Andromity работает на базе LiteLLM и поддерживает 396+ моделей облачных и локальных провайдеров. Активную модель можно сменить на лету в любой момент диалога:

Откройте выбор модели командой /model в терминале или с помощью элемента выбора модели в VS Code. Выберите провайдера и точный идентификатор его модели. Команда в терминале открывает окно выбора; она не переключает модель по аргументу, указанному после команды.

Сочетание клавиш: нажмите Ctrl + L (или Cmd + L в macOS), чтобы сразу открыть переключатель моделей.


Конфиденциальность данных и телеметрия

Andromity работает по принципам zero-PII (без персональных данных):

  1. Маршрутизация через провайдеров: запросы идут по маршруту выбранного провайдера. Провайдеры, подключённые напрямую по модели BYOK, получают промпт и контекст кода, необходимые для инференса; маршрут через шлюз Andromity пересылает запросы через edge-прокси без сохранения состояния. Шлюз не сохраняет промпты, ответы модели и исходный код. Локальный эндпоинт Ollama выполняет инференс на той машине, где он запущен. Ознакомьтесь с политикой обработки данных вашего провайдера и проверьте, какие сетевые инструменты включены.
  2. Локальное хранение: сеансы диалогов и история шагов хранятся только на вашем локальном компьютере в ~/.andromity/sessions/.
  3. Управление телеметрией: для оптимизации edge-маршрутизации отправляются анонимные метрики задержки и коды ошибок. Вы можете отказаться от этого в любой момент:
    • задайте telemetry = false в ~/.andromity/config.toml;
    • или экспортируйте DO_NOT_TRACK=1 в профиле вашей командной оболочки.

Остальные страницы документации доступны на английском языке. Открыть документацию на английском