Об этом проекте

StarNet — локальное настольное приложение, которое позволяет создавать ИИ-агентов, размещать их на пиксельной космической станции и наблюдать, как они выполняют реальную работу с использованием реальных моделей и инструментов. Станция — не просто декорация: это живое отражение состояния среды выполнения, где комнаты представляют команды с ограниченными возможностями, коридоры — авторизованные пути передачи задач, а размещённые объекты — реальные выданные полномочия. Основные возможности: - Создание нескольких агентов с различными классами, персонами и комплектами оснастки; каждый работает параллельно в собственном рабочем пространстве с ограниченными разрешениями. - Использование собственных ключей API (OpenRouter, Anthropic, OpenAI, Google), которые безопасно хранятся в системном хранилище ключей ОС; фронтенд никогда не работает с секретами. - Подключение агентов к мессенджерам, таким как Telegram, Discord, Slack, Signal или Matrix, для удалённого взаимодействия. - Работа с локальными моделями через Ollama без ключа API и каких-либо затрат. - Планирование задач через cron, запуск многошаговых рецептов и предоставление повторно используемых навыков. - Уточняющие вопросы через Task Briefs вместо догадок. - Передача готовой работы в виде реальных файлов в каталоге OUTBOX. - Подключение серверов Model Context Protocol (MCP) и коннекторов с вставкой ключа или OAuth для расширения возможностей агентов. - Голосовой ввод в режиме push-to-talk и единый голосовой вывод станции. - Постоянные дисковые журналы расходов, бюджетов, истории задач и расписаний. Архитектура разделяет ответственность: - `frontend/`: мир станции на чистом JavaScript и настольный пользовательский интерфейс. - `sidecar/`: локальная среда выполнения агентов на Node.js, отвечающая за провайдеров, инструменты, хранение, бюджеты и согласие. - `shared/`: междоменные контракты событий и схем. - `src-tauri/`: настольная оболочка Rust/Tauri и поставляемая в комплекте среда выполнения. - `test/` и `qa/`: модульные, контрактные, интеграционные тесты и тесты релизных барьеров, а также живые подтверждения QA. Публичный цикл выпусков поддерживает Windows 10/11 (64-бит) и macOS (Apple Silicon и Intel). Пакеты для Linux являются внутренними артефактами сборки и не поддерживаются как публичная целевая платформа. Настольные сборки публикуются на странице выпусков GitHub. Для запуска из исходного кода требуются Node.js 18+ (Node.js 22 соответствует CI), Git и, при необходимости, предварительные компоненты Rust и Tauri для настольной оболочки. Sidecar можно запустить напрямую командой `node sidecar/index.js`, после чего открыть в браузере http://localhost:8787. Для разработки используйте `npm run desktop:dev` и `npm run desktop:build`. Тестирование выполняется через npm-скрипты: `npm run test:fast` (обязательный барьер для слияния), `npm run test:http` (живой набор HTTP/E2E-тестов sidecar), `npm test` (полная проверка) и `npm run security:secrets` (сканирование секретов по всей истории). Готовность релиза проверяется командой `npm run qa:ready`. Приветствуются вклад в проект; см. CONTRIBUTING.md и Кодекс поведения. Об уязвимостях безопасности следует сообщать частным образом в соответствии с SECURITY.md. Проект является открытым программным обеспечением под лицензией MIT. Лицензия распространяется только на код; название StarNet, логотип, графика станции и фирменный стиль принадлежат Andrew Sims и не лицензируются вместе с кодом. Форк должны использовать собственные название, логотип и графику и не могут представляться как StarNet или как проект, одобренный исходным проектом.