NeuralAgent：音声とテキストを使ってコンピュータを操作し、タスクを完了させるAIインテリジェンス

NeuralAgentは、ユーザーのローカルコンピュータ上で動作するオープンソースのAI知的身体ツールです。クリック、タイピング、スクロール、アプリケーションのナビゲートといった人間の動作をシミュレートすることで、さまざまなタスクを実行する。ユーザーは自然言語でコマンドを与えるだけで、NeuralAgentがフォームへの入力、電子メールの送信、情報の検索などを自動的に実行する。Windows、macOS、Linuxシステムをサポートし、プライバシー保護のため、クラウドサービスに依存せず、ローカルで実行することに重点を置いている。FastAPIとElectronJSで構築されたこのプロジェクトは、さまざまな大規模言語モデル（GPT-4、Claudeなど）をサポートし、Ollama.NeuralAgentを通じてローカルモデルの使用を可能にします。NeuralAgentは、開発者がさらにカスタマイズできるように、高速でスケーラブルなアーキテクチャを提供します。ユーザーはGitHubでソースコードにアクセスしたり、コミュニティへのコントリビューションに参加したり、Discordを通じてサポートを受けることができる。

機能一覧

• タスクの自動化アプリケーションを開く、フォームに記入する、電子メールを送信するなど、コンピュータ上のアクションを自然言語コマンドで自動化する。
• クロスプラットフォーム対応Windows、macOS、Linuxシステムと互換性がありますが、一部の機能（バックグラウンドブラウザコントロールなど）は現在Windowsのみです。
• マルチモデル対応OpenAI、Anthropic、Azure OpenAI、Bedrock、Ollamaネイティブモデルなど、幅広い大規模言語モデルをサポート。
• コマンドライン機能コマンドバーを常駐させ、ユーザーからのコマンドを受け付け、素早くタスクを実行できるようにします。
• オープンソースで拡張可能MITライセンスに基づき、開発者はコードをクローンしたり、修正したり、新しい機能に貢献したりすることができます。
• ローカルオペレーションクラウドサービスは必要なく、ユーザーのプライバシーは保護され、データやオペレーションはローカルで処理される。
• バックオフィス・オートメーションブラウザーからアプリケーションを自動検索・操作するなど、バックグラウンドで実行されるタスクをサポート。

ヘルプの使用

設置プロセス

NeuralAgentをローカルで実行するには、以下の手順に従ってインストールする必要があります。このプロセス全体には、基本的なプログラミングの知識とターミナルコマンドの使い方が必要です。

1. コードベースのクローン
   ターミナルで以下のコマンドを実行して、NeuralAgent コードをローカルにクローンします：

   git clone https://github.com/withneural/neuralagent.git
   

   クローニングが完了したら、プロジェクト・ディレクトリに移動する：

   cd neuralagent
   

2. 仮想環境の設定
   依存関係の衝突を避けるため、Pythonの仮想環境を作成することを推奨する。Pythonの仮想環境は backend ディレクトリで実行する：

   cd backend
   python -m venv venv
   

   仮想環境をアクティブにする：

   • ウィンドウズ

     venv\Scripts\activate
     

   • macOS/Linuxシステム：

     source venv/bin/activate
     

3. 依存関係のインストール
   バックエンドの依存関係を仮想環境にインストールします：

   pip install -r requirements.txt
   

   次に desktop ディレクトリにフロントエンドの依存関係をインストールします：

   cd ../desktop/neuralagent-app
   npm install
   

4. PostgreSQLデータベースの設定
   NeuralAgentはローカルのPostgreSQLデータベースを必要とします。ユーザはまず PostgreSQL をインストールする必要があります（詳細は PostgreSQL の公式サイトを参照してください）。データベースを作成したら、環境変数を設定します：

   export DB_HOST=localhost
   export DB_PORT=5432
   export DB_DATABASE=neuralagent
   export DB_USERNAME=your_username
   export DB_PASSWORD=your_password
   export DB_CONNECTION_STRING=postgresql://your_username:your_password@localhost:5432/neuralagent
   export JWT_ISS=NeuralAgentBackend
   export JWT_SECRET=your_random_string
   

   そうしれいかん your_usernameそしてyour_password 歌で応える your_random_string 実際の値に置き換える。JWT_SECRET コマンドで生成できるランダムな文字列である必要がある：

   openssl rand -hex 32
   

5. AIモデルの設定
   NeuralAgent はさまざまな大規模言語モデルをサポートしており、ユーザは必要に応じて API キーまたはローカルモデルを設定する必要があります。例えば、OpenAI：

   export OPENAI_API_KEY=your_openai_key
   

   ローカルのOllamaモデルを使用する場合は、Ollamaサービスが実行され、セットアップされていることを確認してください：

   export OLLAMA_URL=http://127.0.0.1:11434
   export CLASSIFIER_AGENT_MODEL_TYPE=ollama
   export CLASSIFIER_AGENT_MODEL_ID=gpt-4.1
   

   同様に、Anthropic、Azure OpenAI、またはその他の対応モデルを設定することもできる。

6. サービス開始
   ターミナルウィンドウを2つ開き、バックエンドとフロントエンドをそれぞれ起動する：
   • バックエンド backend (カタログ）：

     uvicorn main:app --reload
     

   • フロントエンド desktop/neuralagent-app (カタログ）：

     npm start
     

7. インストールの確認
   起動すると、NeuralAgent のインターフェイスがデスクトップに表示されます。ユーザはコマンドバーにコマンドを入力することで、NeuralAgentが正しく動作しているかどうかをテストすることができます。例えば、"Open Notepad and write 'Hello World'"と入力します。

使用方法

NeuralAgentの中核は、自然言語コマンドによってコンピュータ操作を実行することである。以下に主な機能の詳細な操作の流れを示す：

• タスクの自動化
  コマンドバーに自然言語コマンドを入力する：

  查找 5 个热门 GitHub 仓库，然后在记事本中记录并保存到桌面
  

  NeuralAgentは自動的にブラウザを開き、GitHub Trendsのページを検索して情報を抽出し、メモ帳を開いて内容を入力して保存する。ユーザーが手動で行う必要はなく、AIがすべてやってくれる。

• コマンドライン操作
  NeuralAgentのコマンドバーは常駐インターフェースで、指示を受け付ける準備ができている。ユーザーは次のように入力できる：

  打开 Gmail 并发送一封邮件给 test@example.com，主题为‘测试’，内容为‘这是 NeuralAgent 发送的邮件’
  

  NeuralAgentは自動的にブラウザを開き、（あらかじめ設定されたログイン情報で）Gmailにログインし、メールの内容を入力して送信します。

• ローカルモデルの使用
  Ollamaが設定されていれば、ネイティブ・モデルをタスク処理に使用することができる。ユーザーは、コンピュータが大規模な言語モデルを実行するのに十分な性能を持っていることを確認する必要がある。セットアップが完了すると、命令の処理が速くなり、ネットワーク接続も不要になります。例

  在终端运行 'ls -l' 并记录输出到文件
  

  NeuralAgent はターミナルコマンドを実行し、結果を保存します。

• 開発者のカスタマイズ
  開発者は backend ディレクトリのPythonコードか desktop/neuralagent-app ディレクトリ内のReactフロントエンド・コード。たとえば、新しい機能を追加するには aiagent カタログ pyautogui スクリプト。GitHub経由でPull Requestを提出するためのコミュニティサポート。

ほら

• 最初の実行は、依存関係をダウンロードするためのインターネット接続を確保するために必要である。
• ブラウザコントロールなどのバックグラウンド自動化機能は、macOSやLinuxでは制限がある場合があります。
• ローカルモデルを使用するには高性能のハードウェア（GPUなど）が必要で、そうでないと動作が遅くなる可能性がある。
• NeuralAgentはマウスとキーボードを直接操作しますので、テスト時には注意してください。

アプリケーションシナリオ

1. オフィスオートメーション
   ユーザは、電子メールの一括送信やファイルの整理などの繰り返し作業を迅速に処理する必要があるが、NeuralAgentは、「Excelを開き、表データを整理して保存する」といった1つのコマンドでこれを行うことができる。
2. デベロッパー・デバッグ・ツール
   開発者は NeuralAgent を使用して、テストスクリプトを自動的に実行したり、ターミナルコマンドを実行したりすることができます。例えば、「Python スクリプトを実行し、エラーログをデスクトップに保存する」。
3. 教育と学習
   NeuralAgentを使ってコマンドライン操作を学ぶことができます。例えば、「ターミナルで git コマンドを実行し、その出力を解釈する」と入力すると、NeuralAgent がコマンドを実行し、命令を生成します。
4. コンテンツ制作サポート
   クリエイターは、NeuralAgentに自動的に素材を検索させ、整理することができる。例えば、"風景画像を10枚検索してフォルダに保存する"。

品質保証

1. NeuralAgentはクラウドサービスを必要としますか？
   NeuralAgentはローカルコンピュータ上で動作し、データ処理や操作はユーザのプライバシーを保護するためにローカルで行われます。
2. ローカルの大規模言語モデルのサポートはありますか？
   サポートする。ユーザーはOllamaを通じてローカルモデルを設定できるが、ハードウェアの性能が十分であることを確認する必要がある。
3. 取り付けにはどのくらい時間がかかりますか？
   ネットワークやハードウェアにもよるが、通常10～30分。コードのクローン作成と依存関係のインストールにほとんどの時間がかかる。
4. 低性能のコンピューターでも動作しますか？
   実行は可能だが、ローカルモデルを使用する場合は、高性能のCPUまたはGPUを推奨する。
5. どうすれば開発に参加できますか？
   GitHub リポジトリをクローンし、コードを変更して Pull Request を送信してください。