このプロジェクトについて

StarNetはローカルファーストのデスクトップアプリケーションであり、AIエージェントを作成し、それらをピクセルアートの宇宙ステーションに配置して、実際のモデルとツールを使って実際の作業を実行する様子を観察できます。ステーションは単なる装飾ではなく、実行時状態のライブ投影です。部屋は機能範囲を限定されたチームを表し、廊下は許可された引き継ぎレーンであり、配置されたオブジェクトは実際の機能付与です。 主な機能は次のとおりです: - 異なるクラス、ペルソナ、ロードアウトを持つ複数のエージェントを作成でき、各エージェントは制限された権限で独自のワークスペースを並行実行します。 - OpenRouter、Anthropic、OpenAI、GoogleのAPIキーを持ち込め、OSのキーチェーンに安全に保存されます。フロントエンドがシークレットを保持することはありません。 - リモート操作のために、エージェントをTelegram、Discord、Slack、Signal、Matrixなどのメッセージングプラットフォームに接続できます。 - APIキーや費用なしで、Ollama経由でローカルモデルを使用できます。 - cronによるタスクのスケジュール、複数ステップのレシピの起動、再利用可能なスキルの付与ができます。 - 推測で進めるのではなく、タスクブリーフを通じて明確化の質問を行います。 - 完成した作業をOUTBOXディレクトリ内の実際のファイルとして届けます。 - Model Context Protocol(MCP)サーバー、キー貼り付け/OAuthコネクタを接続してエージェントの機能を拡張できます。 - プッシュトゥトークの音声ディクテーションと、統一されたステーション音声出力を利用できます。 - 支出、予算、タスク履歴、スケジュールのためのディスク上の永続台帳を備えています。 アーキテクチャは関心ごとに分離されています: - `frontend/`:素のJavaScriptによるステーションワールドとデスクトップUI。 - `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`(ライブsidecar HTTP/E2Eスイート)、`npm test`(完全な検証)、`npm run security:secrets`(全履歴シークレットスキャン)。リリース準備は`npm run qa:ready`で検証されます。 コントリビューションを歓迎します。CONTRIBUTING.mdと行動規範を参照してください。セキュリティ脆弱性はSECURITY.mdに従って非公開で報告してください。 このプロジェクトはMIT Licenseの下でオープンソース化されています。ライセンスはコードのみを対象とし、StarNetの名称、ロゴ、ステーションアートワーク、ブランドアイデンティティはAndrew Simsが所有し、コードと共にライセンスされるものではありません。フォークは独自の名称、ロゴ、アートワークを使用する必要があり、StarNetを名乗ったり、プロジェクトから承認されていると表明したりすることはできません。