Skip to content

Latest commit

 

History

History
242 lines (163 loc) · 14.6 KB

File metadata and controls

242 lines (163 loc) · 14.6 KB
CraftBot

ほとんどのエージェントハーネスは、チャットとツール呼び出しで止まります。CraftBotはその先へ進みます。自分自身のSaaSツールを構築し、進化させ、運用し、そのツールレイヤーを通じてあなたとコミュニケーションし、自動化を行います。

それに加えて、CraftBotは汎用エージェントハーネスとしてのコア機能をすべて備えています。リモート従業員のようにタスクを実行し、あなたの好みや目標を記憶し、あなたにとって大切なことを能動的に計画・実行する手助けをします。

Windows macOS Linux GitHub Repo stars License Discord Ask DeepWiki

SPONSORED BY E2B FOR STARTUPS

English | 简体中文 | 繁體中文 | 한국어 | Español | Português | Français | Deutsch

✨ 主な特徴

自前のSaaSツールを作って動かせるAIエージェントというだけでなく、CraftBotはエージェントハーネスのコア機能をひと通り備えており、あなたのタスク・ツール・記憶・日々のワークフローと一緒に動く汎用AIエージェントとして機能します。

  • エージェントプロファイル 40以上のエージェントプロファイル(CEOエージェント、財務エージェント、マーケティングリードエージェント、DevOpsエンジニア、動画プロデューサーエージェントなど37種類)があなたのために働く準備が整っています。CraftBot Agent Bundles から欲しいロールを見つけ、ワンクリックでインポートできます。
  • プレイブックカタログ AIエージェントで何を自動化すればよいかわからない?CraftBotには120のプレイブック(19カテゴリーにまたがる)がすぐに使える状態で用意されています。上部バーからプレイブックピッカーを開き、プレイブックを選ぶと、すぐにタスクを実行してくれます。
  • Living UI. CraftBotの中で動くカスタムアプリを構築・インポート・進化させられます。エージェントはUIの状態を常に把握し、そのデータを直接読み書き・操作できます。
  • マルチタスクとセッションルーティング. まだ/newコマンドを叩いていますか?CraftBotは、いつ新しいセッションを始め、いつ既存のタスクを再開すべきかを自分で判断し、会話とコンテキストを一本化します。
  • セルフホスト & BYOK. OpenAI、Google Gemini、Anthropic Claude、OpenRouterなどに対応する柔軟なLLMプロバイダーシステム。Ollamaを使えば、自分のモデルをトークン消費ゼロでホストすることも可能です。
  • メモリーシステム. CraftBotとのやり取りから構築されるセカンドブレイン。ハイブリッド構成:RAG + ナレッジグラフ + エージェントファイルシステム。CraftBotは深夜に「夢を見て」、その日の出来事を統合します。
  • 能動的なエージェント. あなたの好み、習慣、人生の目標を学習。そのうえで計画を立て、タスクを起動(もちろん承認付きで)し、あなたの人生をより良くする手助けをします。
  • 外部ツールとの連携. Google Workspace、Slack、Notion、Zoom、LinkedIn、Discord、Telegramなどのアプリと接続可能(今後さらに追加予定)。OAuthまたは自分のキーでの利用に対応しています。各連携には複数のアカウントを接続できます。
  • スキル & MCP. 150以上のMCPと170以上のスキルが利用可能。新しいスキルやMCPもすぐに導入できます。完了したタスクからワンクリックでスキルを作成・改善することもできます。
  • ブラウザUIとCLIに対応. あなたの使い方に合わせて選べます。日常使いには手軽なブラウザUIを、スクリプトやヘッドレス環境にはCLIをどうぞ。

🧰 はじめに

必要条件: Python 3.10+ ・ ブラウザモードを使う場合は Node.js 18+

# 1. リポジトリをクローン
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot

# 2. インストール、自動起動の登録、CraftBotの起動
python craftbot.py install

これだけです。ターミナルは自動で閉じ、CraftBotはバックグラウンドで稼働し、ブラウザが自動で開きます。再度ブラウザを開けるようにデスクトップショートカットも作成されます。

インストール後のサービス管理:

python craftbot.py start      # CraftBotをバックグラウンドで起動
python craftbot.py stop       # CraftBotを停止
python craftbot.py restart    # CraftBotを再起動
python craftbot.py status     # 実行状態と自動起動の有無を確認
python craftbot.py logs       # 最近のログ出力を表示
python craftbot.py uninstall  # 停止・自動起動の解除・パッケージのアンインストール

Tip

installstartの後には、CraftBotのデスクトップショートカットが自動で作成されます。ブラウザを閉じてしまったら、このショートカットをダブルクリックするだけで再び開けます。


🌱 Living UI

Living UIは、あなたのニーズに合わせて進化していくシステム/アプリ/ダッシュボードです。

CraftBot Banner
  • AIコパイロット付きのカンバンボードが欲しい?
  • 自分のワークフローにぴったり合うカスタムCRMは?
  • CraftBotがあなたに代わって読み取り・操作できる社内ダッシュボードは?

Living UIとして立ち上げれば、CraftBotと並んで動作し、あなたのニーズの変化に合わせて成長します。

Living UIを作る3つの方法

  1. ゼロから構築. 欲しいものを自然な言葉で説明してください。CraftBotが データモデル、バックエンドAPI、ReactのUIを足場として組み上げ、 構造化された設計プロセスを通して一緒に改善していきます。
Building a Living UI from scratch
  1. マーケットプレイスからインストール. コミュニティが作ったLiving UIをliving-ui-marketplaceから探せます。
Living UI marketplace
  1. 既存プロジェクトをインポート. Go、Node.js、Python、Rust、 または静的なソースコードやGitHubリポジトリをCraftBotに渡してください。ランタイムを検出し、ヘルスチェックを設定し、Living UIとしてラップします。
Importing an existing project as a Living UI

CraftBotを内部に組み込んだまま進化し続ける

Living UIに「完成」はありません。ニーズが変われば、機能を追加したり、 ビューをリデザインしたり、新しいデータと連携させたり、エージェントに頼んでください。

CraftBotはすべてのLiving UIに組み込まれており、状態を常に把握しています。 現在のDOMやフォーム値を読み取り、REST API経由で アプリのデータを参照し、あなたに代わってアクションを起こせます。

SaaSツールをオープンに、生き続けるものへ

自分専用のLiving UIを構築・カスタマイズ・進化させ、自分の用途に完璧には合わないサブスクリプションツールへの依存を減らしていきましょう。


5分で試せる3つのLiving UI

  • 📋 カンバンボード: タスク、フォローアップ、CTAをすべて一か所に。CraftBotが操作してPM業務を肩代わりできます。
  • 📊 習慣トラッカー: 習慣を作り、追跡する。開発者がコミットを刻むように、GitHub風のアクティビティカレンダーで習慣を可視化。
  • 🐦 Luolinglo: Duolingoではないですが、新しい言語を学び、フラッシュカードを作り、CraftBotと一緒に練習できます。

Living UIマーケットプレイスを見る・投稿する →


🔧 トラブルシューティングとよくある問題

Node.jsが見つからない (ブラウザモード)

python run.pyを実行したときに 「npm not found in PATH」 と表示された場合:

  1. nodejs.orgからLTS版をダウンロード
  2. インストール後、ターミナルを再起動
  3. もう一度python run.pyを実行

代替手段: 代わりにCLIモードを使用(Node.js不要):

python run.py --cli

依存関係のせいでインストールに失敗する

インストーラーは詳細なエラーメッセージと対処法を表示するようになりました。失敗した場合:

  • Pythonのバージョンを確認: Python 3.10以上か確認(python --version)
  • インターネット接続を確認: インストール中に依存関係をダウンロードします
  • pipキャッシュをクリア: pip install --upgrade pipを実行してからやり直す

Playwrightのインストールに失敗する

Playwright Chromiumのインストールは任意です。失敗しても:

  • 他のタスクではエージェントは問題なく動作します
  • スキップして、あとからplaywright install chromiumでインストール可能
  • WhatsApp Web連携を使う場合にのみ必要です

詳しいトラブルシューティングは INSTALLATION_FIX.md を参照してください。


🐳 コンテナで実行する

リポジトリのルートには、Python 3.10、主要なシステムパッケージ(OCR用のTesseractを含む)、そしてenvironment.yml/requirements.txtで定義されたすべてのPython依存関係を含むDocker構成が用意されており、隔離された環境でもエージェントを一貫して動かせます。

以下は、コンテナでエージェントを動かすための手順です。

イメージをビルドする

リポジトリのルートから:

docker build -t craftbot .

コンテナを実行する

イメージは既定でpython -m app.mainを起動するように設定されています。インタラクティブに動かす場合:

docker run --rm -it craftbot

環境変数が必要な場合は、envファイルを渡してください(例として.env.exampleを元に作成):

docker run --rm -it --env-file .env craftbot

コンテナ外に永続化したいディレクトリ(データやキャッシュなど)は-vでマウントし、ポートやその他のフラグもデプロイ要件に応じて調整してください。コンテナにはOCR用(tesseract)や一般的なHTTPクライアントなどのシステム依存が同梱されているので、ファイル操作やネットワークAPIをコンテナ内でそのまま扱えます。

既定ではPython 3.10を使い、environment.yml/requirements.txtのPython依存関係を取り込んでいるので、python -m app.mainがすぐに動きます。


🤝 コントリビュート方法

PR歓迎です! ワークフロー(フォーク → devからブランチを切る → PR)についてはCONTRIBUTING.mdをご覧ください。すべてのプルリクエストはリント + スモークテストCIを自動で通過します。

Important

CraftBotは毎週改善が入る、活発に開発中のプロジェクトです。質問や素早いやり取りがしたい場合は、Discordに参加するか、thamyikfoong(at)craftos.net までメールしてください。


🧾 ライセンス

このプロジェクトは MITライセンス の下で公開されています。自由に利用・ホスト・収益化していただけます(配布や収益化を行う場合は、本プロジェクトのクレジット表記が必要です)。


⭐ 謝辞

CraftOS とコントリビューターによって開発・メンテナンスされています。
CraftBot が役に立ったら、ぜひリポジトリに⭐を付けて、他の人にもシェアしてください!


スター履歴

Star History Chart