RU Getting Started - VVG-web/aurora-studio GitHub Wiki
-
Python 3.11+ (лучше 3.14; 3.10 работает с предупреждением, 3.9 не поддерживается) и git. Зависимости времени выполнения перечислены в
requirements.txt; необязательные ставятся со страницы «Установка» в панели. - По желанию:
pandoc(выгрузка в docx/pdf),beautifulsoup4+markdownify(синк Confluence),markitdown,openpyxl,pypdf(офисные документы). Раздел панели Установка показывает, чего не хватает и какие команды от этого зависят. - По желанию: OpenAI-совместимый шлюз LLM для встроенного агента. Всё, что не требует модели, работает без него.
git clone https://github.com/<org>/aurora-studio.git
cd aurora-studio
python3 aurora.py new /путь/к/вашему-проекту # развернуть в новую или существующую папку; ответить на вопросы
python3 aurora.py cockpit # открыть локальную панель управленияНет терминала? Дважды щёлкните start-aurora.command (macOS) или start-aurora.bat (Windows): он проверит Python и git,
предложит поставить недостающее и откроет панель. Без терминала вопросы настройки пропускаются, проект разворачивается со
значениями по умолчанию — доделайте настройку позже: python3 aurora.py setup <проект> или в панели.
Папку проекта с фиксированной раскладкой (одинаковой во всех проектах Авроры): Sources/ (зеркала, пишутся только
синком), Raw/ (неизменяемые доказательства), AuroraKnowledgeDB/ (карточки), Artifacts/, Deliverables/,
Workspaces/ и .aurora/ с копией движка. Подробности: INSTALL.
Склонируйте проект и откройте его в панели — терминал не нужен. .aurora/ (копия движка) через git не едет, поэтому клон
приходит без неё; при выборе проекта панель сама достроит её из кита и скажет, что создала (kit:update --engine-only:
только пути под .aurora/, файлы проекта и git не меняются). Остальное обновление — AGENTS.md, шаблоны, правила
.gitignore — меняет git, поэтому ждёт кнопки Версия → Предпросмотр обновления → Применить. Состояние
движка (ok, missing, incomplete, stale) видно в Версии и в kit:doctor.
-
Проверьте готовность. В панели
kit:doctor(илиpython3 aurora.py doctor <проект>): он называет, чего не хватает — репозитория git, конфига,AGENTS.md, секрета, которому не место в git. -
Заполните настройки.
aurora.config.yamlхранит адреса, пространства, ключи проектов и JQL (он в git); токены — в.env.aurora.local(он вне git). Образец —aurora.env.local.example. См. INSTALL, разделы 3–4. - Откройте проект в панели и нажмите «Обновить базу». Она синхронизирует зеркала, собирает карточки партиями, пишет тезисы, связывает карточки, считает доверие и фиксирует каждый оборот в git. Останавливать можно в любой момент: сделанное остаётся годным. → Цикл
-
Загляните в «Здоровье». Доля
knowledge, ошибки линтера, что осталось человеку (ops:todo). - Спросите что-нибудь. Раздел Спросить отвечает только по карточкам и ставит ссылку на каждое утверждение. → Спросить базу
| Если вы… | Читайте |
|---|---|
| аналитик, работающий каждый день | Повседневная работа, затем Практика |
| настраиваете команду | Правила команды, Уход за базой |
| подключаете Confluence и Jira | Источники и зеркала |
| подключаете LLM | Агент |
Эта wiki собирается из папки wiki/ репозитория — правьте страницы там, изменения, сделанные здесь, будут перезаписаны. · Home