Communityコーディング&開発github.com

shamspias/reins

アプリケーションに簡単に組み込める軽量エージェントハーネスで、LLMが安全かつ低コストで操作できるようにします。

reins とは?

Reinsは、開発者が自身のアプリケーションにLLM(大規模言語モデル)エージェントの操作能力を安全かつ低コストで追加できる軽量ハーネスです。このツールは、アプリケーションの特定の機能やAPIをLLMに公開し、エージェントが自律的に行動できるようにするためのフレームワークを提供します。主なユースケースとしては、ソフトウェアの自動テスト、データパイプラインの管理、カスタマーサポートボットの強化などが含まれ、Claude CodeやCursor、Codexといった主要なAIエージェントプラットフォームでの利用を想定しています。Reinsの核となるのは、最小限のオーバーヘッドで実装できるシンプルなインターフェースと、LLMの誤った操作からシステムを保護する安全機構です。これにより、エージェントは与えられた権限の範囲内でタスクを実行でき、開発者はコストを気にせずに実験できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add shamspias/reins

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

reins は何をしますか?

アプリケーションに簡単に組み込める軽量エージェントハーネスで、LLMが安全かつ低コストで操作できるようにします。

概要

Reinsは、あなたのアプリケーションにLLMエージェントの制御を追加するためのシンプルな方法を提供します。このツールを使用すると、アプリケーションの機能をエージェントに公開し、自律的なタスク実行を安全に実現できます。

主な機能

  • 軽量設計: 最小限の依存関係で、既存のプロジェクトに素早く統合できます。
  • 安全な操作: LLMの誤ったアクションからシステムを保護するためのビルトイン安全機構を備えています。
  • 低コスト: 効率的なAPI呼び出しとリソース管理により、運用コストを抑えます。
  • プラットフォーム互換性: Claude Code、Cursor、Codexなどの主要なAIエージェントプラットフォームで動作します。

クイックスタート

pip install reins

または、ソースからビルドする場合:

git clone https://github.com/shamspias/reins
cd reins
pip install -e .

使用方法

Reinsをアプリケーションに統合する基本的な例を以下に示します。

import reins

# アプリケーションのアクションを定義
def get_user_data(user_id: str):
    # ユーザーデータを取得するロジック
    return {"id": user_id, "name": "John Doe"}

def send_email(to: str, subject: str, body: str):
    # メール送信ロジック
    print(f"Sending email to {to}: {subject}")

# ハーネスを作成
harness = reins.Harness()

# アクションを登録
harness.register_action("get_user_data", get_user_data, "Get user data by ID")
harness.register_action("send_email", send_email, "Send an email to a user")

# LLMエージェントにハーネスを渡す
# これにより、エージェントは登録されたアクションを使用できる

設定

環境変数または設定ファイルでReinsの動作をカスタマイズできます。

環境変数説明デフォルト値
REINS_LOG_LEVELログレベルINFO
REINS_MAX_RETRIESアクション実行の最大リトライ回数3
REINS_TIMEOUTアクション実行のタイムアウト(秒)30

安全機構

Reinsは、LLMエージェントが予期しない動作をした場合に備えて、以下の安全機構を提供します。

  • アクションの許可リスト: エージェントが実行できるアクションを制限できます。
  • レート制限: 一定時間内のアクション実行回数を制限します。
  • 入力検証: エージェントからの入力が適切かどうかを検証します。

開発

コントリビューションを歓迎します!以下の手順で開発を始めてください。

# リポジトリをクローン
git clone https://github.com/shamspias/reins.git
cd reins

# 開発用依存関係をインストール
pip install -e ".[dev]"

# テストを実行
pytest

ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細についてはLICENSEファイルを参照してください。

貢献

バグ報告、機能リクエスト、プルリクエストは大歓迎です。詳細はCONTRIBUTING.mdをご覧ください。


Reinsを使って、あなたのアプリケーションをよりスマートに、より安全に操作しましょう!

関連スキル