Shivaratnakumar/developer-study-helper-agent

Developer Study Helper は、開発者向けの学習支援を目的とした Python CLI ツールです。Typer ベースのサブコマンドからモード別の system プロンプト（ペルソナとルール）とユーザー入力を組み合わせて、1 回の chat.completions 呼び出しで応答を取得し、Rich で Markdown 表示します。応答はターミナル中心で、進捗やトピック統計は任意でローカルの JSON に保存します。 対象ユーザー: 個人開発者や面接準備中のエンジニア。主な用途はQ&A、コード生成、エラー解析、模擬面接、履歴書レビュー、進捗確認など。音声入出力（オフラインTTS / STT）もオプションで利用可能。 主な特徴: - プラガブルな LLM バックエンド（OpenAI や Ollama の OpenAI 互換 /v1 を利用） - モードごとに固定の system prompt を持ち、振る舞いを一貫化・テスト可能に - 基本は「コマンドにつき単一の補完呼び出し」でシンプルかつステートレス（mock-interview のみ複数ターン） - 進捗は ~/.developer-study-helper/progress.json に保管（Pydantic モデル）、ストリークやトピック統計を管理 - シンプル構成（cli.py, prompts.py, llm.py, progress_store.py, voice_io.py）で面接で説明しやすい設計 セットアップは Python 3.11+、仮想環境下で pip install -e .。Ollama をローカル利用するか、OPENAI_API_KEY / OPENAI_BASE_URL を設定してクラウド利用します。設計上のトレードオフはローカルJSONの単純さ（並行書き込みに弱い）がある一方、ゼロ設定で扱いやすい点を優先しています。

AI-related keywords found in this repo's description, topics, or README summary — grouped by category. Each badge links to the corresponding ranking detail page.