samadhitheguild-debug/avelina-ai

avelina-ai は何をしますか？

個人用AIアシスタント (Claude Agent SDK上) — メモリ、スキル、マルチボットエージェントを備えたTelegramボット。

概要

Avelinaは、Claude Agent SDKを活用して構築された個人用AIアシスタントです。Telegram上で動作し、長期記憶、動的なスキル読み込み、複数のボットエージェントによる協調作業をサポートします。ユーザーは自然言語でタスクを依頼するだけで、エージェントが自律的に処理を実行します。

特徴

• 長期記憶: 会話やタスクの履歴を保持し、文脈を理解して応答します。
• スキルシステム: プラグイン可能なスキルモジュールにより、機能を拡張できます。
• マルチボットエージェント: 複数のボットが連携して複雑なタスクを分担・実行します。
• Telegram統合: Telegramのチャットインターフェースから直接操作可能です。
• Claude Agent SDKベース: SDKの全機能を活用し、高い拡張性と信頼性を提供します。

動作環境

• Python 3.10+
• Claude Agent SDK
• Telegram Bot API

クイックスタート

1. リポジトリをクローンします: git clone https://github.com/samadhitheguild-debug/avelina-ai.git
2. 依存パッケージをインストール: pip install -r requirements.txt
3. 環境変数 TELEGRAM_TOKEN と CLAUDE_API_KEY を設定します。
4. ボットを起動: python main.py

使用方法

Telegramでボットにメッセージを送信するだけで使用を開始できます。

/start - ボットを初期化
/help - ヘルプを表示
/skill list - 利用可能なスキルを表示
/skill load <name> - スキルを動的に読み込み

スキル開発

独自のスキルを追加するには、skills/ ディレクトリに新しいPythonファイルを作成し、所定のインターフェースに従って実装します。詳細はSKILL_DEVELOPMENT.mdを参照してください。

貢献

バグ報告や機能リクエストは、GitHub Issuesにてお寄せください。プルリクエストも歓迎します。