Skip to content

README.ja.md

Latest commit

 

History

History
207 lines (143 loc) · 9.39 KB

README.ja.md

File metadata and controls

207 lines (143 loc) · 9.39 KB
Raw

Polywise Logo Polywise

オープンソースのエージェント型コンテンツシステム

X Discord License npm

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

ライトモードでは太陽のイラスト、ダークモードでは月と星が表示されます。

Polywise とは

Polywise はオープンソースのエージェント型コンテンツシステムです。コマンドラインやデスクトップアプリからモデルと会話し、知識を保存し、文脈を引き出し、繰り返し使う作業スタイルを再利用可能な agents に変えていけます。

🚀 インストール

Polywise を使い始める入口は、実用的には CLI とデスクトップアプリの 2 つです。

CLI

まず CLI をグローバルにインストールします。

npm install -g polywise

ローカルの Polywise サービスを起動します。

polywise start
polywise start -d

polywise start はサービスをフォアグラウンドで実行します。polywise start -d はすぐに終了しますが、サービスはバックグラウンドで動き続けます。

その後、Web UI の http://localhost:3072/app/ を開いてください。

設定画面から Auth ログインを有効にできます。有効化してパスワードを設定すると、Web UI にアクセスするたびにログインが必要になり、API も保護されます。Polywise をサーバーにデプロイしてリモート利用するなら、ここはかなり重要です。

デスクトップアプリ

最新のデスクトップビルドは GitHub Releases からダウンロードできます。

セッション、保存済みコンテンツ、agents、posts をターミナルなしで見て回りたいなら、デスクトップアプリがいちばん手軽です。

初回起動

最初に必要なのは、基本的には次の 2 点です。

  • 利用可能なモデルプロバイダーを 1 つ
  • 保存済みコンテンツの検索も使いたいなら、embedding モデルと rerank モデル

初日からすべての provider や integration を設定し切る必要はありません。

⬆️ アップグレード

CLI

polywise upgrade

デスクトップアプリ

GitHub Releases から最新リリースをインストールしてください。

⚡ クイックスタート

最短で価値を感じたいなら、まずは次の流れがおすすめです。

  1. Settings -> Model Provider を開き、今すぐ実際に使える provider を 1 つ設定する。
  2. Settings -> Model Setting を開き、デフォルトのチャットモデルが使える状態か確認する。
  3. Session に移動し、hello ではなく本物の質問を 1 つ投げる。
  4. 短いメモ、ページ要約、回答のどれかを 1 つ Polywise に保存する。
  5. その保存した項目をチャットでもう一度触れて、検索できることを確かめる。

🧭 使い方

provider を 1 つつなぎ、デフォルトモデルも設定できたら、設定ばかり触らずそのまま使い始めるのがいちばんです。

デスクトップアプリ

各エリアに 1 つずつ具体的な役割を持たせると、アプリの全体像がかなり掴みやすくなります。

  • Session は本物の質問をしたり、作業を整理したり、ワークスペースの文脈の中で進めたりするときに使う
  • Linkcase は Web コンテンツを取得してシステムに取り込むときに使う
  • Agent は繰り返し出てくる指示スタイルを再利用可能な協働相手に育てるために使う
  • Posts はチャット返信以上に長く残したい知識を保存するために使う

早めに覚えておくと便利なショートカットは 2 つあります。

  • @ はファイル、agents、そのほかの文脈を session に持ち込む
  • / はツールや skills をワークフローに呼び出す

CLI

CLI はバックエンド API を薄く包んだラッパーです。デフォルトでは http://localhost:3072 に接続します。サーバーが別の場所にある場合は POLYWISE_SERVER_URL を設定してください。

コマンドを暗記するより、まずはヘルプから入るのがおすすめです。

polywise -h
polywise session -h
polywise session create -h

コマンドの入力形式を正確に知りたいときは input_schema を使います。

polywise input_schema session.create

よく使うコマンド:

polywise start
polywise start -d
polywise version
polywise session create --title "Daily Review"
polywise search fullTextSearch --query "vector database"
polywise save --for user --content "Key takeaway..."

ペイロードが複雑になってきたら、JSON をそのまま渡せます。

polywise search fullTextSearch --json '{"query":"agent memory","for_types":["wiki","memory"],"enable_recall":true}'

📚 ドキュメント

🎬 Intro Video

Open the intro video file

💭 Polywise の考え方

Polywise は、本当に賢い AI には、本当に賢い記憶が必要だという考えを土台に作られています。単に保存するだけではなく、つながりを自然に作り、使うほど強くなり、必要に応じて忘れ、時間とともに進化していく仕組みを目指しています。

📄 参考文献

このプロジェクトは以下の研究論文から着想を得ています。

🙏 謝辞

Polywise は、以下の素晴らしいオープンソースプロジェクトに支えられています。

Libraries & Tools

  • 🐘 Sqlite - 世界でもっとも広く使われている高性能組み込みデータベースのひとつ
  • 🏹 sqlite-vec - Sqlite にベクトル検索機能を追加
  • ⚛️ React - フロントエンド UI ライブラリ
  • 🖥️ Electron - デスクトップアプリケーションフレームワーク
  • 🔗 tRPC - エンドツーエンドで型安全な API
  • 📦 MobX - シンプルで拡張しやすい状態管理
  • 🎨 Tailwind CSS - ユーティリティファーストの CSS フレームワーク
  • 🚀 Hono - 超高速な Web フレームワーク
  • 🛠️ Rsbuild - Rspack ベースの次世代ビルドツール
  • 📚 Rslib - Rsbuild ベースのライブラリビルドツール
  • 🤖 AI SDK - AI アプリケーション開発のための統合ツールキット
  • 🤗 node-llama-cpp – ローカルモデルとつなぐための llama-cpp 向け Node.js バインディング

📜 ライセンス

MIT - 詳細は LICENSE を参照してください。