С чего начать

Короткий путь от установки до своей первой программы: как запустить платформу, что где в мастерской, как собрать программу руками и как поручить её помощнику, что делать, если что-то пошло не так. Подробно каждое окно описано в Мастерская.

1 Что такое O.G.A.S.

O.G.A.S. — платформа, на которой человек собирает программы для себя. Программа состоит из двух частей:

• граф — что программа делает: узлы, соединённые связями. Узел — один шаг: начать работу по нажатию кнопки, записать значение, выбрать путь, вызвать модуль;
• пульт — окно программы, которым ею пользуются: кнопки, поля, таблицы, картинки.

Модуль — шаг, который нельзя собрать из узлов: нейросеть, разбор файла, обращение к сервису в сети. Модули пишут на Python или Rust; готовые берут в библиотеке.

Собирают программу в мастерской — окне платформы. Собранная программа включается и работает, пока её не выключат: ждёт нажатий, сообщений, времени. Один запуск — одна работа программы от события до конца.

2 Установка и запуск

2.1 Что нужно

• Windows 10 версии 2004 и новее или Windows 11, 64-разрядная, с включённой в BIOS виртуализацией;
• сеть на время установки: установщик ставит WSL и Linux для платформы;
• для нейросетей — видеокарта NVIDIA с драйвером Windows; без неё работает всё, кроме модулей, которым она нужна.

Установщик ogas-setup-<версия>.exe с ogas.space ведёт по трём этапам — ничего не запускает, пока не нажмёшь «Проверить» или другую кнопку проверки, и показывает каждую команду с ответом; у каждого этапа своя сводка «что будет сделано» и журнал внизу окна: WSL и Linux — проверка виртуализации (выключена — как её включить), WSL, если её нет, и Linux для платформы: имеющийся или свой «OGAS» на выбранном диске, с именем и паролем, которые задаёшь тут же, и обновления WSL и Linux — стоит самое новое, так и сказано: «последняя версия»; пакеты Linux — что каждая группа даёт и сколько займёт, что уже стоит; O.G.A.S. — папка в Linux, ярлык «O.G.A.S.». Пароль во время установки не спрашивается, потом его спрашивает sudo. Если O.G.A.S. уже стоит — обновить, переустановить или изменить набор пакетов (Сборка, установка и обслуживание, 2.1).

Как собрать платформу из исходников и что лежит в поставке — Сборка, установка и обслуживание.

2.2 Запуск

С Windows — ярлык «O.G.A.S.» в «Пуске» или на рабочем столе; собранная из исходников платформа — двойной щелчок по ogas.cmd. Окно консоли не остаётся: ярлык и ogas.cmd запускают платформу через запускатель ogas-start.exe; без него (мастерская не собрана) ogas.cmd держит консоль открытой, и в ней видны ошибки запуска. Из WSL — в папке платформы:

./ogas

Платформа поднимается и открывает мастерскую. Пока она не ответила, окно пишет «Подключение к платформе…». Закрытое окно уходит к значку у часов, а платформа работает дальше: включённые программы ждут своих событий. «Выйти» в меню значка или знак выхода в мастерской останавливают платформу.

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

Проверить, всё ли на месте, — до запуска:

./ogas doctor

Проверка называет, чего не хватает: программы окна, запуска программ Windows из WSL, Python, видеокарты.

2.3 Программа без мастерской

Готовую программу открывают сразу её окном, без мастерской:

./ogas program --process <id программы>

С Windows — ogas.cmd program --process <id> или ярлык программы с теми же словами в конце командной строки.

Запустить программу один раз и получить ответ в командной строке:

./ogas run --process <id программы> --text "что подать на вход"

Команда включает программу, подаёт текст в её событие, ждёт конца запуска и останавливает платформу; код выхода 0 — запуск прошёл.

3 Мастерская с первого взгляда

По краям окна — панели, в центре — окна, которые из них открывают.

Слева — две панели:

• «Мастерская» — то, чем собирают: «Граф», «Создание пульта», «Модули», «Журнал программы», «Помощник» и «Создать» — новая программа;
• «Платформа» — то, чем управляют платформой: «Библиотека», «Журнал платформы», «Настройки», язык, тема, «Справка» — эта документация на сайте — и выход.

Справа — твои панели программ: какие они, как называются и какие программы на них стоят, решаешь ты в библиотеке; щелчок по значку открывает программу.

Любое окно устроено одинаково: слева колонка — что можно выбрать или поставить, справа рабочее поле, а выбранное в поле открывается в панели поверх его нижней части. Окна двигают и меняют им размер; свёрнутое окно ложится капсулой в нижнюю полосу.

Открыто может быть несколько программ сразу: у каждой свои окна, вкладка окна называет программу.

4 Первая программа

Соберём программу «Привет»: поле для имени, кнопка, и под ними ответ «Привет, <имя>!».

1. Создать. На панели «Мастерская» — «Создать», имя «Привет». Открывается окно графа новой программы.
2. Переменные. В колонке графа заведи две переменные текста: name — имя, said — ответ. Переменная — место, где программа держит значение; пульт показывает и меняет её.
3. Событие. Поставь из колонки на холст узел «Событие» и в его панели выбери источник «пульт»: такой узел начинает запуск, когда на пульте нажимают кнопку.
4. Ответ. Поставь узел «Шаблон» и напиши в нём Привет, {name}!: в фигурных скобках — поле данных, которые пришли в узел; имя принесёт кнопка (шаг 7). Шаблон добавит к данным поле text с готовым ответом. Поставь узел «Запись», выбери в нём переменную said и поле text.
5. Связи. Протяни связь от выхода события к входу шаблона, от выхода шаблона — к входу записи. Порт, к которому связь подходит, светится зелёным; к которому нельзя — красным, и окно говорит почему.
6. Проверить и сохранить. «Проверить» называет, что в графе не так; «Сохранить» записывает программу. Сохраняется только граф, прошедший проверку.
7. Пульт. Открой «Создание пульта». Поставь поле и привяжи его к name; кнопку — к событию, и пусть она несёт с собой name: нажатие кладёт значение переменной в данные запуска; «Значение» — к said. Подпиши их: «Имя», «Поздороваться», «Ответ». «Сохранить».
8. Включить и запустить. В окне графа — «Включить». Впиши имя в поле пульта и нажми кнопку. Под ними появится ответ.

Что делает каждый вид узла, какие у него входы, выходы и настройки — Виды узлов. Готовую программу ставят на свою панель справа в библиотеке: на панели — кнопка «+».

5 Помощник

Помощник собирает программы и модули по задаче, написанной словами. Думает за него нейросеть, которую ты подключаешь, — по API или на этом компьютере.

5.1 Подключить сеть

«Помощник» → «Сеть помощника». Выбери сеть:

• по API — OpenAI и всё, что говорит его протоколом (DeepSeek, OpenRouter, Mistral, Groq и другие), Anthropic, Gemini, GigaChat, YandexGPT. Впиши ключ сервиса: он ложится в файл .env модуля сети и больше нигде не хранится. Задача и то, что прочтёт помощник, уходят на сервер поставщика; работа оплачивается по его расценкам;
• на этом компьютере — «Локальная сеть»: сеть текста из папки нейросетей. Задачи никуда не уходят, но нужна видеокарта и окружение Python с её пакетами — его выбирают в поле «Окружение».

Сеть собирает программы тем лучше, чем она больше. Небольшие локальные сети справляются с простыми вещами и часто говорят «сделано», ничего не сделав; помощник это замечает, напоминает сети, а панель честно пишет, что записано не было.

5.2 Дать задачу

Напиши, что нужно, и нажми «Отправить» (или Ctrl+Enter). Под твоими словами видно, что помощник делает: смотрит виды узлов, заводит черновик, записывает граф, проверяет. Каждое действие отмечено: ✓ — прошло, ✗ — отказано, и наведённая мышь показывает подробности. Когда помощник закончил, он говорит, что сделал и как этим пользоваться; ответить ему или попросить ещё — в том же поле.

• «Стоп» останавливает задачу перед следующим шагом.
• Предел. Задача останавливается, когда израсходовала свой предел шагов или токенов — кусочков текста, по которым считается плата у сетей по API, — и ждёт «Продолжить». Пределы задаются в настройках помощника.
• «Попросить людей» открывает на сайте ogas.space форму обращения с твоей задачей: может, её соберёт человек.

5.3 Что помощнику можно

• Только черновики — так по умолчанию. Помощник меняет лишь то, что создал сам, — свои черновики и модули, — и ничего не включает. Твои программы он только читает.
• Расширенный доступ — помощник меняет и твои программы, включает их и нажимает их события. Его дают на задачу после предупреждения: ответственность за его действия — на тебе. Перед тем как впервые за задачу переписать твою программу, помощник сохраняет её прежний вид в data/assistant/before/.

Ни в каком доступе помощник не читает ключи и секреты, не меняет настройки платформы и не удаляет.

6 Модули и нейросети

Библиотека — всё, что у тебя есть: программы, модули, нейросети, заготовки интерфейса. Там же источники — откуда их скачивают: витрина ogas.space, Hugging Face, Civitai и другие витрины. Вещь с непроверенной витрины перед установкой спрашивает доверия — каждый раз.

Нейросеть одна на все модули, которые её берут: файл или папку нейросети кладут в подпапку её вида в папке нейросетей, которую показывает библиотека. Какую нейросеть берёт узел, выбирают в его панели.

Окружение. Модулю на Python с пакетами нужно окружение программы: «Модули» → «Установить окружение». Платформа сама ничего не ставит — только по этой кнопке. Перед первой установкой мастерская предупреждает: модуль работает с твоими правами, песочницы у него нет.

Свой модуль заводят в библиотеке — «Создать модуль» — или командой OGAS SDK; как его написать — OGAS SDK. Чужой модуль принимают в библиотеке: «Принять модуль» показывает, что он принесёт, и после вопроса о доверии ставит его.

7 Включение, запуск, остановка

• Включить программу — в окне графа или кнопкой её пульта. Включается программа такой, какой записана: изменённый граф сначала сохраняют. Включённую программу не меняют — её поля только для чтения, пока её не выключат; другие программы в это время собирают как обычно.
• Запуск начинает событие: кнопка пульта, сообщение, время, включение программы. Пока запуск идёт, на графе подсвечены узлы, которые работают, а пульт показывает значения по мере записи.
• Вопрос. Программа может спросить тебя: вопрос появляется на пульте, и ответ ведёт запуск дальше. Мастерская зовёт уведомлением, когда программа спрашивает или запуск упал.
• «Остановить» прерывает запуск. То, что модули уже сделали снаружи, — отправленное письмо, записанный файл — не откатывается.
• «Повтор» повторяет упавший шаг. Если исход шага неизвестен — модуль мог успеть что-то сделать, — платформа не повторяет его сама, а спрашивает.
• Продолжить прерванный запуск можно, пока программу не меняли: запуск, снятый с одной версии графа, на другой не продолжается.

Что оставил запуск — файлы, картинки, звук — во вкладке «Результаты» его строки в «Журнале программы». «Открыть» открывает файл программой Windows, «Показать в папке» — в Проводнике; программы и сценарии не открываются, их только показывают в папке.

8 Когда что-то не так

• «Журнал программы» — запуски программы: когда, каким событием, чем кончились; у сбоя — причина словами и узел, на котором он случился.
• «Журнал платформы» — события самой платформы и проблемы: часть платформы не работает, модуль упал, текста не хватает. Проблема открывается с кодом и переходом к подробностям; что значит код — Коды ошибок.

Таблица 1 — Что видно и что это значит

9 Настройки

«Настройки» — слева «Состояние» платформы и разделы, справа настройки раздела; значение меняют в панели выбранной настройки, «?» рядом объясняет её. Что делает каждая настройка — Настройки.

Вход для программ («Прочие настройки» → «Вход для программ») пускает твои программы — сценарии OGAS SDK, редакторы — работать с платформой. Он закрыт, пока ты его не откроешь; программа входит по ключу, который там же можно показать, скопировать или выпустить новый. С ключом программа может делать в платформе всё, что ты делаешь в мастерской, кроме остановки платформы и смены самого входа.