agnai

強靱な

お気に入りの AI サービスを使用して、パーソナライズされたキャラクターと AI ロールプレイ チャットを行います。

ライブバージョン |不和

Agnai.chat でライブ バージョンをご覧ください。

PygmalionAI による Galatea-UI の初期の作品に基づいています。

---

クイックスタート

重要！ MongoDB と Redis はオプションです。 MongoDB が利用できない場合、Agnaistic は「ゲストのみ」モードで実行されます。

Agnaistic は NPM パッケージとして公開されており、グローバルにインストールできます。

 # Install or update:
npm install agnai -g
agnai

# View launch options:
agnai help

# Run with the Pipeline features
agnai --pipeline

NPM パッケージを使用する場合、画像と JSON ファイルはHOME_FOLDER/.agnaiに保存されます。
例:
Linux: /home/sceuick/.agnai/
Mac: /Users/sceuick/.agnai
Windows: C:Userssceuick.agnai 。

特徴

• グループ会話: 複数のユーザーと複数のボット
• 複数の AI サービス: Kobold、Novel、AI Horde、Goose、OpenAI、Claude、Replicate、OpenRouter、Mancer のサポート
• 複数のペルソナ スキーマ形式: W++、角かっこ形式 (SBF)、Boostyle、プレーン テキスト
• マルチテナント:
  • ユーザー認証
  • ユーザー設定: 使用する AI サービスと独自の設定
  • ユーザー生成プリセット
• 定期購入
• 記憶/伝承の本
• AIでキャラクターを生成
• サードパーティサービスを使用した画像生成
• オプションのパイプライン機能
  • 長期記憶
  • ウィキペディアの記事と PDF の埋め込み

手動で実行する

3. Node.jsをインストールする
4. MongoDB のインストール(オプション)
   • データベースはオプションです。使用可能なデータベースがない場合、Agnaistic はanonymous-onlyモードで実行されます。
   • Anonymousユーザーのデータはブラウザのローカル ストレージに保存されます。データは「存続」しますが、デバイスや他のブラウザ間で共有することはできません。ブラウザのアプリケーション データ/Cookie をクリアすると、このデータも削除されます。
5. プロジェクトをダウンロードします: git clone https://github.com/agnaistic/agnaiまたはダウンロードします
6. ターミナル/コンソールのクローン/解凍されたフォルダー内から:
   • npm run deps
     • 念のため、AgnAI を更新するたびにこれを実行してください。
     • これにより、 pnpm v8使用して依存関係がインストールされます。
   • npm run build:all
   • 監視モードでプロジェクトをビルドして実行します。
     • Mac/Linux: npm run start
     • Windows: npm run start:win
   • ローカル トンネルを使用してプロジェクトをビルドして実行します。
     • Mac/Linux: npm run start:public
     • Windows: npm run start:public:win

Docker で実行する

1. プロジェクトのクローンを作成する
2. MongoDB の場合: docker compose -p agnai -f self-host.docker-compose.yml up -d
3. MongoDB なし: docker run -dt --restart=always -p 3001:3001 ghcr.io/agnaistic/agnaistic:latest
   • -dtコンテナを切り離して実行します
   • --restart=always起動時またはサーバーがクラッシュした場合に再起動します
   • -p 3001:3001ポート 3001 を公開しますhttp://localhost:3001でアプリにアクセスします。

セルフホスティング設定

ユーザーが特定のニーズに合わせて必要とする小さな微調整やチューニングにアプリケーション レベルで対応できるようにするために、 settings.jsonがあります。
ルート レベルでsettings.jsonというファイルを作成して、アプリケーション全体に変更を適用できます。
アプリケーションに特別なニーズがある場合は、ここで対応を依頼してください。

これらのリクエストに応えることと、コードベースで制御不能にならないことの間のバランスを見つけようと思います。

これに適したリクエストの例:

• 「デフォルトのメモリーブック」をすべてのユーザーに適用したい。
• 提供されているものとは異なるエンド トークンのセットを使用したいと考えています。
• 匿名アクセスを無効にしたい

設定.json

使用可能なすべての設定の例については、 template.settings.jsonをコピーするか参照してください。変更を有効にするには、Agnai を再起動する必要があります。

現在サポートされているカスタム設定:

• baseEndTokens : 追加の応答終了トークンを基本セットに追加します。

開発者向け

推奨される開発ツール

次の拡張機能を備えた VSCode を使用することを強くお勧めします。

• Prettier - Code formatter : 自動フォーマット用
• Tailwind CSS Intellisense : Tailwind CSS クラスによるオートコンプリートとインテリセンス用
• そして、 "editor.formatOnSave": true VSCode settings.jsonに追加して、Prettier で自動フォーマットします

pnpm start使用する場合、Node.JS サーバーは--inspectを使用して実行されます。これは、デバッグにさまざまな Inspector クライアントを使用できることを意味します。

技術スタック

スタックの重要な部分は次のとおりです。

• 永続化のための MongoDB
• WebSocket の分散メッセージング用の Redis。
• インタラクティブ性のための SolidJS
• TailwindCSS のスタイリング用
• 依存関係管理のための pnpm

起動

 # Install dependencies - Always run this after pulling changes
> npm run deps

# Run MongoDB using Docker
> npm run up

# Start the frontend, backend, and python service
# Mac/Linux
> npm start

# Windows
> npm run start:win

# Install and run Pipeline API
# If required, this will update the dependencies before running the API
> npm run model # Install poetry into a virtual environment

# Run everything with a single command:
> npm run start:all # Linux and OSX
> npm run start:all:win # Windows

この時点で、ブラウザで http://localhost:3001 にアクセスして UI を表示できるようになります。

http://localhost:1234 でホットリロードを使用してフロントエンドへのアクセスを試みることもできます。

推奨される開発者ツール

• Redux開発ツール
  • フロントエンド アプリケーションの状態は、Chrome 拡張機能「Redux Dev Tools」に関連付けられています。
• NodeJS デバッガー
  • pnpm startスクリプトは--inspectフラグを使用して NodeJS API を起動します
  • VSCode のデフォルトの起動タスクを使用してアタッチ ( F5 )
  • または、URL chrome://inspectに移動してデバッガーを使用します
• Poetryを使用した Python 依存関係管理 - https://python-poetry.org/docs/cli
  • .model/bin/poetry [...args]

フォーマットと型のチェック

このプロジェクトでは、リンティングに ESLint を、コード スタイルの適用に Prettier を、型エラーのチェックに TypeScript を使用します。 PR を開くときは、以下を実行して、これらのチェックで新しいエラーが発生していないことを確認してください。

 # auto-fixes any style problems
$ pnpm run format:fix

# runs the TypeScript compiler so any type errors will be shown
$ pnpm run typecheck

このプロジェクトは BrowserStack でテストされています。