Быстрый старт локально
Ниже — минимальный путь от пустой папки до открытого веб-интерфейса GigaAgent на Python 3.12.
Требования
- Python 3.12 или совместимая версия Python 3.11+.
uvдля установки в отдельное окружение. Можно использовать иpip, ноuvобычно быстрее и удобнее.- Свободный локальный порт
9090.
Запуск за несколько минут
mkdir giga-agent-demo
cd giga-agent-demo
uv venv --python python3.12 .venv
source .venv/bin/activate
uv pip install "giga-agent[jupyter]==0.1.9"
giga_agent dev
Откройте:
http://localhost:9090
Первый запуск может занять заметное время: команда загружает зависимости, подготавливает локальный секретный ключ, проверяет миграции и поднимает сервер разработки.
Файл .env для первого локального запуска можно не создавать. Ключи провайдеров моделей и другие прикладные секреты можно добавить позже в веб-интерфейсе.
Первый вход
На чистой локальной базе создаётся пользователь администратора:
| Поле | Значение |
|---|---|
| Почта | admin@example.com |
| Пароль | giga_agent_admin |
Для локальной демонстрации этого достаточно. Для общего сервера пароль и секретный ключ нужно заменить; см. Совместный сервер.
Проверка миграций
Обычно giga_agent dev запускает миграции сам. Если нужна явная проверка:
giga_agent migrate
giga_agent check
Если сначала выполнить giga_agent check на пустой базе, команда может сообщить, что миграции ещё не применены. Это ожидаемо; выполните giga_agent migrate, затем повторите проверку.
Важные адреса
| Адрес | Назначение |
|---|---|
http://localhost:9090/ | Веб-интерфейс. |
http://localhost:9090/app-config.js | Рабочая конфигурация интерфейса. |
http://localhost:9090/api/info | Служебная информация сервера LangGraph. |
http://localhost:9090/api/agent/... | Маршруты GigaAgent. |
Для обычного пользователя достаточно открыть веб-интерфейс. Прямые HTTP-запросы нужны при диагностике или интеграции.
Дальше
- Чтобы агент начал отвечать в чате, настройте языковую модель: Первый чат.
- Чтобы понять, какие функции требуют дополнительных провайдеров, см. Возможности и требования.
- Ошибки запуска разобраны в разделе Диагностика.