設定

Astreus CLIを環境変数で設定し、完全にカスタマイズしましょう。これらの設定は、CLI自体と、エージェント開発中に使用する基盤のAstreusフレームワーク機能の両方を制御します。

環境設定

ホームディレクトリに.envファイルを作成するか、シェルプロファイルで変数をエクスポートします。

完全な設定例

# ===== CLI SETTINGS =====

# Default provider and model
ASTREUS_PROVIDER=openai    # openai, claude, gemini, ollama
ASTREUS_MODEL=gpt-4o       # Default model name

# ===== LLM PROVIDERS API KEYS =====

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here      # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key     # Optional

# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here      # Optional

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here         # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key        # Optional

# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434

# ===== DATABASE CONFIGURATION =====

# Main Application Database (Agents, Memory, Tasks, etc.)
DB_URL=sqlite://./astreus.db

# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db

# ===== KNOWLEDGE/RAG SYSTEM =====

# Knowledge Vector Database (PostgreSQL with pgvector required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db

# ===== APPLICATION SETTINGS =====

NODE_ENV=development       # development | production | test
LOG_LEVEL=info             # debug | info | warn | error | silent

# ===== DATABASE ENCRYPTION =====

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

必須の変数

最低でも1つのLLMプロバイダーのAPIキーが必要です。

# Choose one:
export OPENAI_API_KEY=sk-...
# or
export ANTHROPIC_API_KEY=...
# or
export GEMINI_API_KEY=...
# or just run Ollama locally

デフォルトのプロバイダーとモデル

お好みのデフォルト値を設定します。

# Always start with Claude
export ASTREUS_PROVIDER=claude
export ASTREUS_MODEL=claude-sonnet-4-20250514

# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3

データベース設定

SQLite (デフォルト)

ローカル開発では、SQLiteはそのまま動作します。

DB_URL=sqlite://./astreus.db

PostgreSQL (本番環境)

本番環境や共有環境向けです。

DB_URL=postgresql://user:password@localhost:5432/astreus_db

ナレッジデータベース

RAG/ナレッジ機能を使用する場合は、pgvectorを備えたPostgreSQLが必要です。

KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

セキュリティ設定

暗号化

機密データの暗号化を有効にします。

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

安全なキーを生成します。

openssl rand -hex 32

ロギング

ログの詳細度を制御します。

# Options: debug | info | warn | error | silent
LOG_LEVEL=info

シェルプロファイルの設定

~/.bashrc、~/.zshrc、または~/.profileに追加します。

# Astreus CLI Configuration
export OPENAI_API_KEY="sk-your-key"
export ASTREUS_PROVIDER="openai"
export ASTREUS_MODEL="gpt-4o"

その後、再読み込みします。

source ~/.zshrc  # or ~/.bashrc

設定の確認

現在の設定を確認します。

# Start CLI and check settings
astreus
/settings

これにより、現在の設定を表示する設定パネルが開きます。

エージェント開発ワークフロー

最良のエージェント開発体験を得るために。

1. 複数のプロバイダーを設定する

複数のAPIキーを設定して、さまざまなLLMでエージェントをテストできるようにします。

# All providers configured
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."

2. プロジェクトアタッチメントを使用する

エージェントプロジェクトに取り組む際は、フォルダをアタッチして完全なコンテキストを与えます。

astreus
/attach ./my-agent-project

CLIはプロジェクトの構造、既存のコード、設定を理解します。

3. セッションで反復する

開発セッションは自動的に保存されます。続きから再開できます。

astreus
/sessions  # See and restore previous sessions

4. 異なるモデルをテストする

エージェントのコードが生成されたら、異なる基盤モデルでどのように動作するかをテストします。

/provider claude   # Test with Claude
/provider openai   # Test with GPT-4o
/provider ollama   # Test locally

最終更新日: 2026年7月6日

このセクション内

はじめに

Astreusフレームワークでエージェントを構築するためのAI搭載開発アシスタントです。CLIは、Astreus SDKを完全に理解した状態で、ターミナルから直接AIエージェントを作成、テスト、反復開発する手助けをします。

インストール

Astreus CLIを数分で使えるようにしましょう。このCLIは、Astreusフレームワークでエージェントを構築するためのAI搭載アシスタントです。信頼性の高いAstreusエージェントシステムを構築するために必要なセットアップのパターン、API、実践的な例を学びましょう。

コマンド

Astreus CLIの全コマンドとキーボードショートカットの完全なリファレンスです。これらのコマンドを使って、エージェント開発セッションを管理し、モデルを切り替え、ワークフローを整理しましょう。

プロバイダー

はじめに