icron は何をしますか？
🤖 軽量で拡張可能なパーソナルAIアシスタントを提供し、複数プラットフォームとOpenAI互換モデルをサポートして、多様な自動化と支援を実現します。
概要
0rcaaa/icronは、最小限のリソースで動作するよう設計されたパーソナルAIアシスタントです。OpenAI互換のAPIエンドポイントに接続することで、様々なAIモデル（GPT、Claude、ローカルモデルなど）を利用し、会話、タスク実行、コード生成などの機能を提供します。
主な特徴
- 軽量設計: 最低限の依存関係で動作し、リソース消費が少ない。
- 拡張可能: プラグインシステムにより、カスタムアクションや機能を追加可能。
- マルチプラットフォーム: Claude Code、Cursor、Codexなど、複数の開発環境で利用可能。
- OpenAI互換: OpenAI API形式に対応したあらゆるモデル（OpenAI、Anthropic、ローカルモデルなど）を利用可能。
- 自動化支援: 定型作業の自動化、ファイル操作、スクリプト実行などをエージェントが代行。
セットアップ
前提条件
- Python 3.8以上
- OpenAI互換APIキー（例：
OPENAI_API_KEY）
インストール
pip install icron
または、リポジトリをクローンして直接使用:
git clone https://github.com/0rcaaa/icron.git
cd icron
pip install -r requirements.txt
設定
環境変数を設定:
export OPENAI_API_KEY="your-api-key-here"
export ICRON_MODEL="gpt-4" # または使用するモデル名
export ICRON_PLATFORM="claude" # 例: claude, cursor, codex
使用方法
基本的な会話
from icron import Assistant
assistant = Assistant()
response = assistant.chat("Hello, what can you do?")
print(response)
カスタムアクションの追加
actions/ディレクトリにPythonスクリプトを配置することで、独自のアクションを追加できます。
例: actions/weather.py
def get_weather(location: str) -> str:
# 天気情報を取得するロジック
return f"The weather in {location} is sunny."
プラットフォーム対応
| プラットフォーム | 状態 |
|---|---|
| Claude Code | ✅ 対応 |
| Cursor | ✅ 対応 |
| Codex | ✅ 対応 |
| カスタムCLI | ✅ 対応 |
ドキュメント
詳細なドキュメントは こちら を参照してください。
ライセンス
MIT License