Ryvos を 5 ヶ分で始めるガイド

Ryvos は Rust で構築されたオープンソースの AI コーディングアシスタントおよびエージェントランタイムです。単一のバイナリのみで、15〜30 MB の RAM 必要、14 の LLM プロバイダー対応。ご自身のハードウェアで動作します。 コーヒーを煎る間に、完全に機能する AI コーディングアシスタントをローカルで起動できます。その具体的な手順は以下の通りです。 OS: Linux または macOS（Windows 対応はロードマップで予定されています） LLM API キー、またはローカル Ollama インスタンス（無料、アカウント不要） curl と sh（すべての *nix システムに事前インストール済み） curl -fsSL https://raw.githubusercontent.com/Ryvos/ryvos/main/install.sh | sh これで完了。インストーラーは： ・ご自身の OS とアーキテクチャに適合するバイナリをダウンロードする ・それを ~/.local/bin/ryvos に配置し（PATH に自動的に追加される） ・設定とデータを保管する ~/.ryvos/ を作成する 動作を確認： ryvos --version # ryvos 0.5.0 Rust 要件なし。インストーラーは事前構築されたバイナリをダウンロードします。ソースからビルドしたい場合以外、Rust ツールチェーンは不要です。 インタラクティブセットアップ Wizard を実行： ryvos init プロバイダーと API キーを入力する必要があります。Ryvos は 14 のプロバイダーをサポートしており、以下のものが一般的なスタートアップポイントです： 質問に答える場合： Provider: anthropic Model: claude-sonnet-4-20250514 API key: console.anthropic.com から取得したキー オプション B: OpenAI Provider: openai Model: gpt-4o API key: platform.openai.com から取得したキー まず Ollama をインストールしモデルをダウンロード： ollama pull qwen2.5:7b 次に Ryvos を以下のコマンドで実行： ryvos init -y --provider ollama --model-id qwen2.5:7b API キーは不要。すべてがご自身のマシンで動作します。 インタラクティブセッションを開始： ryvos プロンプトが表示されます。具体的な試みに挑戦してください： > 最後の 5 つの git コミットをこのディレクトリで要約せよ Ryvos は： ・git log を実行する必要があるかどうかを判断する ・セキュリティポリシー（T3 — shell コマンド）に従い、承認を求めるか自動的に実行する ・コマンドを実行し出力を読み、英言葉での要約を提供する さらにいくつかを試してみてください： > 今日変更したファイルは何ですか？ > この関数が何をするか説明せよ > auth モジュールのユニットテストを記述せよ インタラクティブモードを使わない場合は、ryvos run を使用します： ryvos run "現在ディレクトリ内のすべての TODO コメントをリストし、ファイルごとにグループ付けせよ" これはエージェントを実行しタスクを完了させて終了します。スクリプトとアリアスに最適です。 ryvos doctor これはセットアップに関する診断を実行します：API 接続性、ワークスペースアクセス、データベース、セキュリティポリシー、構成された MCP サーバー。より進む前に、警告を修正してください。 最初のタスクを実行した時、Ryvos は： ・あなたの要求を目標と成功基準に変換する ・使用すべきツールを計画する（この場合は、62 つの組み込みツールの内の git_log） ・セキュリティティアをチェックする（git log は T1 (低リスク)、自動的に承認される） ・ツールを実行し出力をストリーミングする ・その組み込み Judge を使用して結果を目標に対して評価する ・答えを返して終了する。無限ループなし。 これは目標導致的な実行です。エージェントはターン制限に達するまで、タスクが完了するまで実行されます。 デフォルトでは、Ryvos は慎重なセキュリティポリシーを使用しています： ツールティア 例 デフォルトの動作 T0 — Safe ファイルを読める 自動的に実行される T1 — Low Web 検索、git log 自動的に実行される T2 — Medium ファイルを記せる 承認を求める T3 — High Shell コマンドを実行する 承認を求める T4 — Critical rm -rf、DROP TABLE 完全にブロックされる この設定を ~/.ryvos/config.toml で調整できます： [security] auto_approve_up_to = "t2" # ファイル書き込みも自動的に承認 deny_above = "t4" # 破壊的なコマンドをブロック approval_timeout_secs = 60 あなたは使い込む AI コーディングアシスタントを所有しています。ここから先はいかがでしょうか： パーソナライズ： ryvos soul エージェントのパーソナリティ、トーン、および明確化の求め方を形作る 5 つの質問インタビュー。 ターミナル UI を使用： ryvos tui ストリーミング出力付きの完全な ratatui ベースの TUI。セッションが長い場合、REPL よりもクリーンです。 Web UI を実行： ryvos serve ブラウザアクセサブルなインターフェース http://localhost:18789 を開きます。共有アクセスや別のマシンから使用する場合に有用です。 Telegram / Discord / Slack に接続： ~/.ryvos/config.t

Getting Started with Ryvos in 5 Minutes Ryvos is an open-source AI coding assistant and agent runtime built in Rust. One binary, 15–30 MB RAM, 14 LLM providers — runs on your own hardware. You can have a fully functional AI coding assistant running locally in the time it takes to make coffee. Here's exactly how. Linux or macOS (Windows support coming — see roadmap) An LLM API key — OR a local Ollama instance (free, no account needed) curl and sh (pre-installed on every *nix system) curl -fsSL https://raw.githubusercontent.com/Ryvos/ryvos/main/install.sh | sh That's it. The installer: Downloads the correct binary for your OS and architecture Places it in ~/.local/bin/ryvos (added to your PATH automatically) Creates ~/.ryvos/ for config and data Verify it worked: ryvos --version # ryvos 0.5.0 No Rust required. The install script downloads a pre-built binary. You don't need a Rust toolchain unless you want to build from source. Run the interactive setup wizard: ryvos init You'll be asked to choose a provider and paste an API key. Ryvos supports 14 providers — here are the most common starting points: When prompted: Provider: anthropic Model: claude-sonnet-4-20250514 API key: your key from console.anthropic.com Option B: OpenAI Provider: openai Model: gpt-4o API key: your key from platform.openai.com First install Ollama and pull a model: ollama pull qwen2.5:7b Then run Ryvos with: ryvos init -y --provider ollama --model-id qwen2.5:7b No API key needed. Everything runs on your machine. Start an interactive session: ryvos You'll see a prompt. Try something practical: > Summarize the last 5 git commits in this directory Ryvos will: Determine it needs to run git log Ask for your approval (T3 — shell command) or run automatically depending on your security policy Execute the command, read the output, and give you a plain-English summary Try a few more: > What files did I change today? > Explain what this function does > Write a unit test for the auth module Don't want interactive mode? Use ryvos run: ryvos run "List all TODO comments in the current directory and group them by file" This runs the agent, completes the task, and exits. Good for scripts and aliases. ryvos doctor This runs diagnostics on your setup: API connectivity, workspace access, database, security policy, MCP servers if configured. Fix any warnings before going further. When you ran that first task, Ryvos: Parsed your request into a goal with success criteria Planned which tools to use — in this case, git_log from the 62 built-in tools Checked the security tier — git log is T1 (low risk), auto-approved Executed the tool and streamed the output Evaluated the result against the goal using its built-in Judge Returned the answer — and stopped. No infinite loops. This is goal-driven execution. The agent runs until the task is done, not until it hits a turn limit. By default, Ryvos uses a conservative security policy: Tool tier Example Default behavior T0 — Safe Read a file Runs automatically T1 — Low Web search, git log Runs automatically T2 — Medium Write a file Asks for approval T3 — High Run a shell command Asks for approval T4 — Critical rm -rf, DROP TABLE Blocked outright You can adjust this in ~/.ryvos/config.toml: [security] auto_approve_up_to = "t2" # auto-approve file writes too deny_above = "t4" # block destructive commands approval_timeout_secs = 60 You've got a working AI coding assistant. Here's where to go from here: Personalize it: ryvos soul A 5-question interview that shapes the agent's personality, tone, and how proactively it asks for clarification. Use the terminal UI: ryvos tui A full ratatui-based TUI with streaming output — cleaner than the REPL for longer sessions. Run the web UI: ryvos serve Opens a browser-accessible interface at http://localhost:18789. Useful when you want to share access or use it from another machine. Connect to Telegram / Discord / Slack: ~/.ryvos/config.toml and run: ryvos daemon --gateway Your assistant is now always on — message it from your phone. Add MCP servers: ryvos mcp add filesystem Model Context Protocol lets you connect Ryvos to external tools and data sources — filesystem, databases, APIs, browser automation. ryvos: command not found ~/.local/bin to your PATH, but your current shell session may not have refreshed. Run: source ~/.bashrc # or ~/.zshrc API key errors ryvos doctor — it will test connectivity to your configured provider and show the exact error. Permission denied on tool use ryvos config. Your auto_approve_up_to tier may be too restrictive for the task you're running. GitHub — Ryvos/ryvos Documentation Full configuration reference Security model deep-dive Ryvos is open source (MIT). If this tutorial helped, a GitHub star is appreciated — it helps other developers find the project.