code-puppy 0.0.186__tar.gz → 0.0.314__tar.gz

{code_puppy-0.0.186 → code_puppy-0.0.314}/.gitignore

@@ -20,3 +20,7 @@ wheels/
 dummy_path
 
 .idea/
+
+.DS_Store
+.env
+.serena/

{code_puppy-0.0.186 → code_puppy-0.0.314}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-puppy
-Version: 0.0.186
+Version: 0.0.314
 Summary: Code generation agent
 Project-URL: repository, https://github.com/mpfaffenberger/code_puppy
 Project-URL: HomePage, https://github.com/mpfaffenberger/code_puppy
@@ -14,43 +14,68 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.11
-Requires-Dist: bs4>=0.0.2
+Requires-Python: <3.14,>=3.11
 Requires-Dist: camoufox>=0.4.11
-Requires-Dist: fastapi>=0.110.0
-Requires-Dist: httpx-limiter>=0.3.0
-Requires-Dist: httpx>=0.24.1
+Requires-Dist: dbos>=2.5.0
+Requires-Dist: fastapi>=0.111.0
+Requires-Dist: httpx[http2]>=0.24.1
 Requires-Dist: json-repair>=0.46.2
 Requires-Dist: logfire>=0.7.1
 Requires-Dist: openai>=1.99.1
-Requires-Dist: pathspec>=0.11.0
 Requires-Dist: playwright>=1.40.0
-Requires-Dist: prompt-toolkit>=3.0.38
-Requires-Dist: pydantic-ai<=0.8
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: pydantic-ai==1.25.0
 Requires-Dist: pydantic>=2.4.0
-Requires-Dist: pyjwt>=2.8.0
+Requires-Dist: pyfiglet>=0.8.post1
 Requires-Dist: pytest-cov>=6.1.1
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rapidfuzz>=3.13.0
 Requires-Dist: rich>=13.4.2
-Requires-Dist: ripgrep>=14.1.0
+Requires-Dist: ripgrep==14.1.0
 Requires-Dist: ruff>=0.11.11
 Requires-Dist: tenacity>=8.2.0
-Requires-Dist: termcolor>=3.1.0
-Requires-Dist: textual-dev>=1.7.0
-Requires-Dist: textual>=5.0.0
-Requires-Dist: tree-sitter-language-pack>=0.8.0
-Requires-Dist: tree-sitter-typescript>=0.23.2
-Requires-Dist: uvicorn>=0.29.0
+Requires-Dist: uvicorn>=0.30.0
 Description-Content-Type: text/markdown
 
-# 🐶 Code Puppy 🐶
-![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
-![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)
-  <a href="https://github.com/mpfaffenberger/code_puppy"><img src="https://img.shields.io/pypi/pyversions/pydantic-ai.svg" alt="versions"></a>
-  <a href="https://github.com/mpfaffenberger/code_puppy/blob/main/LICENSE"><img src="https://img.shields.io/github/license/pydantic/pydantic-ai.svg?v" alt="license"></a>
+<div align="center">
+
+![Code Puppy Logo](code_puppy.png)
+
+**🐶✨The sassy AI code agent that makes IDEs look outdated** ✨🐶
+
+[![Version](https://img.shields.io/pypi/v/code-puppy?style=for-the-badge&logo=python&label=Version&color=purple)](https://pypi.org/project/code-puppy/)
+[![Downloads](https://img.shields.io/badge/Downloads-100k%2B-brightgreen?style=for-the-badge&logo=download)](https://pypi.org/project/code-puppy/)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
+[![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/actions)
+[![Coverage](https://img.shields.io/badge/Coverage-95%25-brightgreen?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
+[![Code Style](https://img.shields.io/badge/Code%20Style-Black-black?style=for-the-badge)](https://github.com/psf/black)
+[![Tests](https://img.shields.io/badge/Tests-Passing-success?style=for-the-badge&logo=pytest)](https://github.com/mpfaffenberger/code_puppy/tests)
+
+[![OpenAI](https://img.shields.io/badge/OpenAI-GPT--5-orange?style=flat-square&logo=openai)](https://openai.com)
+[![Gemini](https://img.shields.io/badge/Google-Gemini-blue?style=flat-square&logo=google)](https://ai.google.dev/)
+[![Anthropic](https://img.shields.io/badge/Anthropic-Claude-orange?style=flat-square&logo=anthropic)](https://anthropic.com)
+[![Cerebras](https://img.shields.io/badge/Cerebras-GLM%204.6-red?style=flat-square)](https://cerebras.ai)
+[![Z.AI](https://img.shields.io/badge/Z.AI-GLM%204.6-purple?style=flat-square)](https://z.ai/)
+[![Synthetic](https://img.shields.io/badge/Synthetic-MINIMAX_M2-green?style=flat-square)](https://synthetic.new)
+
+[![100% Open Source](https://img.shields.io/badge/100%25-Open%20Source-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
+[![Pydantic AI](https://img.shields.io/badge/Pydantic-AI-success?style=for-the-badge)](https://github.com/pydantic/pydantic-ai)
+
+[![100% privacy](https://img.shields.io/badge/FULL-Privacy%20commitment-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy/blob/main/README.md#code-puppy-privacy-commitment)
+
+[![GitHub stars](https://img.shields.io/github/stars/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/network)
+
+**[⭐ Star this repo if you hate expensive IDEs! ⭐](#quick-start)**
+
+*"Who needs an IDE when you have 1024 angry puppies?"* - Someone, probably.
+
+</div>
+
+---
+
 
-*"Who needs an IDE?"* - someone, probably.
 
 ## Overview
 
@@ -64,47 +89,145 @@ Description-Content-Type: text/markdown
 
 Code Puppy is an AI-powered code generation agent, designed to understand programming tasks, generate high-quality code, and explain its reasoning similar to tools like Windsurf and Cursor.
 
+
 ## Quick start
 
-`uvx code-puppy -i`
+```bash
+uvx code-puppy -i
+````
 
+## Installation
 
-## Features
+### UV (Recommended)
 
-- **Multi-language support**: Capable of generating code in various programming languages.
-- **Interactive CLI**: A command-line interface for interactive use.
-- **Detailed explanations**: Provides insights into generated code to understand its logic and structure.
+```bash
+# Install UV if you don't have it
+curl -LsSf https://astral.sh/uv/install.sh | sh
 
-## Command Line Animation
+# Set UV to always use managed Python (one-time setup)
+echo 'export UV_MANAGED_PYTHON=1' >> ~/.zshrc  # or ~/.bashrc
+source ~/.zshrc  # or ~/.bashrc
 
-![Code Puppy](code_puppy.gif)
+# Install and run code-puppy
+uvx code-puppy -i
+```
 
-## Installation
+UV will automatically download the latest compatible Python version (3.11+) if your system doesn't have one.
 
-`pip install code-puppy`
+### pip (Alternative)
+
+```bash
+pip install code-puppy
+```
+
+*Note: pip installation requires your system Python to be 3.11 or newer.*
+
+### Permanent Python Management
+
+To make UV always use managed Python versions (recommended):
 
-## Usage
 ```bash
-export MODEL_NAME=gpt-5 # or gemini-2.5-flash-preview-05-20 as an example for Google Gemini models
-export OPENAI_API_KEY=<your_openai_api_key> # or GEMINI_API_KEY for Google Gemini models
-export CEREBRAS_API_KEY=<your_cerebras_api_key> # for Cerebras models
-export YOLO_MODE=true # to bypass the safety confirmation prompt when running shell commands
+# Set environment variable permanently
+echo 'export UV_MANAGED_PYTHON=1' >> ~/.zshrc  # or ~/.bashrc
+source ~/.zshrc  # or ~/.bashrc
 
-# or ...
+# Now all UV commands will prefer managed Python installations
+uvx code-puppy  # No need for --managed-python flag anymore
+```
 
-export AZURE_OPENAI_API_KEY=...
-export AZURE_OPENAI_ENDPOINT=...
+### Verifying Python Version
+
+```bash
+# Check which Python UV will use
+uv python find
 
-code-puppy --interactive
+# Or check the current project's Python
+uv run python --version
 ```
 
-Run specific tasks or engage in interactive mode:
+## Usage
+
+### Custom Commands
+Create markdown files in `.claude/commands/`, `.github/prompts/`, or `.agents/commands/` to define custom slash commands. The filename becomes the command name and the content runs as a prompt.
+
+```bash
+# Create a custom command
+echo "# Code Review
+
+Please review this code for security issues." > .claude/commands/review.md
+
+# Use it in Code Puppy
+/review with focus on authentication
+```
+
+### Adding Models from models.dev 🆕
+
+While there are several models configured right out of the box from providers like Synthetic, Cerebras, OpenAI, Google, and Anthropic, Code Puppy integrates with [models.dev](https://models.dev) to let you browse and add models from **65+ providers** with a single command:
 
 ```bash
-# Execute a task directly
-code-puppy "write me a C++ hello world program in /tmp/main.cpp then compile it and run it"
+/add_model
 ```
 
+This opens an interactive TUI where you can:
+- **Browse providers** - See all available AI providers (OpenAI, Anthropic, Groq, Mistral, xAI, Cohere, Perplexity, DeepInfra, and many more)
+- **Preview model details** - View capabilities, pricing, context length, and features
+- **One-click add** - Automatically configures the model with correct endpoints and API keys
+
+#### Live API with Offline Fallback
+
+The `/add_model` command fetches the latest model data from models.dev in real-time. If the API is unavailable, it falls back to a bundled database:
+
+```
+📡 Fetched latest models from models.dev     # Live API
+📦 Using bundled models database              # Offline fallback
+```
+
+#### Supported Providers
+
+Code Puppy integrates with https://models.dev giving you access to 65 providers and >1000 different model offerings.
+
+There are **39+ additional providers** that already have OpenAI-compatible APIs configured in models.dev!
+
+These providers are automatically configured with correct OpenAI-compatible endpoints, but have **not** been tested thoroughly:
+
+| Provider | Endpoint | API Key Env Var |
+|----------|----------|----------------|
+| **xAI** (Grok) | `https://api.x.ai/v1` | `XAI_API_KEY` |
+| **Groq** | `https://api.groq.com/openai/v1` | `GROQ_API_KEY` |
+| **Mistral** | `https://api.mistral.ai/v1` | `MISTRAL_API_KEY` |
+| **Together AI** | `https://api.together.xyz/v1` | `TOGETHER_API_KEY` |
+| **Perplexity** | `https://api.perplexity.ai` | `PERPLEXITY_API_KEY` |
+| **DeepInfra** | `https://api.deepinfra.com/v1/openai` | `DEEPINFRA_API_KEY` |
+| **Cohere** | `https://api.cohere.com/compatibility/v1` | `COHERE_API_KEY` |
+| **AIHubMix** | `https://aihubmix.com/v1` | `AIHUBMIX_API_KEY` |
+
+#### Smart Warnings
+
+- **⚠️ Unsupported Providers** - Providers like Amazon Bedrock and Google Vertex that require special authentication are clearly marked
+- **⚠️ No Tool Calling** - Models without tool calling support show a big warning since they can't use Code Puppy's file/shell tools
+
+### Durable Execution
+
+Code Puppy now supports **[DBOS](https://github.com/dbos-inc/dbos-transact-py)** durable execution.
+
+When enabled, every agent is automatically wrapped as a `DBOSAgent`, checkpointing key interactions (including agent inputs, LLM responses, MCP calls, and tool calls) in a database for durability and recovery.
+
+You can toggle DBOS via either of these options:
+
+- CLI config (persists): `/set enable_dbos true` (or `false` to disable)
+
+
+Config takes precedence if set; otherwise the environment variable is used.
+
+### Configuration
+
+The following environment variables control DBOS behavior:
+- `DBOS_CONDUCTOR_KEY`: If set, Code Puppy connects to the [DBOS Management Console](https://console.dbos.dev/). Make sure you first register an app named `dbos-code-puppy` on the console to generate a Conductor key. Default: `None`.
+- `DBOS_LOG_LEVEL`: Logging verbosity: `CRITICAL`, `ERROR`, `WARNING`, `INFO`, or `DEBUG`. Default: `ERROR`.
+- `DBOS_SYSTEM_DATABASE_URL`: Database URL used by DBOS. Can point to a local SQLite file or a Postgres instance. Example: `postgresql://postgres:dbos@localhost:5432/postgres`. Default: `dbos_store.sqlite` file in the config directory.
+- `DBOS_APP_VERSION`: If set, Code Puppy uses it as the [DBOS application version](https://docs.dbos.dev/architecture#application-and-workflow-versions) and automatically tries to recover pending workflows for this version. Default: Code Puppy version + Unix timestamp in millisecond (disable automatic recovery).
+
+
 ## Requirements
 
 - Python 3.11+
@@ -114,10 +237,6 @@ code-puppy "write me a C++ hello world program in /tmp/main.cpp then compile it
 - Anthropic key (for Claude models)
 - Ollama endpoint available
 
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
 ## Agent Rules
 We support AGENT.md files for defining coding standards and styles that your code should comply with. These rules can cover various aspects such as formatting, naming conventions, and even design guidelines.
 
@@ -127,8 +246,6 @@ For examples and more information about agent rules, visit [https://agent.md](ht
 
 Use the `/mcp` command to manage MCP (list, start, stop, status, etc.)
 
-In the TUI you can click on MCP settings on the footer and interact with a mini-marketplace.
-
 Watch this video for examples! https://www.youtube.com/watch?v=1t1zEetOqlo
 
 
@@ -640,8 +757,28 @@ Consider contributing agent templates for:
 
 ---
 
-**Happy Agent Building!** 🚀 Code Puppy now supports both Python and JSON agents, making it easy for anyone to create custom AI coding assistants! 🐶✨
+# Code Puppy Privacy Commitment
+
+**Zero-compromise privacy policy. Always.**
+
+Unlike other Agentic Coding software, there is no corporate or investor backing for this project, which means **zero pressure to compromise our principles for profit**. This isn't just a nice-to-have feature – it's fundamental to the project's DNA.
+
+### What Code Puppy _absolutely does not_ collect:
+- ❌ **Zero telemetry** – no usage analytics, crash reports, or behavioral tracking
+- ❌ **Zero prompt logging** – your code, conversations, or project details are never stored
+- ❌ **Zero behavioral profiling** – we don't track what you build, how you code, or when you use the tool
+- ❌ **Zero third-party data sharing** – your information is never sold, traded, or given away
+
+### What data flows where:
+- **LLM Provider Communication**: Your prompts are sent directly to whichever LLM provider you've configured (OpenAI, Anthropic, local models, etc.) – this is unavoidable for AI functionality
+- **Complete Local Option**: Run your own VLLM/SGLang/Llama.cpp server locally → **zero data leaves your network**. Configure this with `~/.code_puppy/extra_models.json`
+- **Direct Developer Contact**: All feature requests, bug reports, and discussions happen directly with me – no middleman analytics platforms or customer data harvesting tools
 
+### Our privacy-first architecture:
+Code Puppy is designed with privacy-by-design principles. Every feature has been evaluated through a privacy lens, and every integration respects user data sovereignty. When you use Code Puppy, you're not the product – you're just a developer getting things done.
 
-## Conclusion
-By using Code Puppy, you can maintain code quality and adhere to design guidelines with ease.
+**This commitment is enforceable because it's structurally impossible to violate it.** No external pressures, no investor demands, no quarterly earnings targets to hit. Just solid code that respects your privacy.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

{code_puppy-0.0.186 → code_puppy-0.0.314}/README.md

@@ -1,10 +1,42 @@
-# 🐶 Code Puppy 🐶
-![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
-![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)
-  <a href="https://github.com/mpfaffenberger/code_puppy"><img src="https://img.shields.io/pypi/pyversions/pydantic-ai.svg" alt="versions"></a>
-  <a href="https://github.com/mpfaffenberger/code_puppy/blob/main/LICENSE"><img src="https://img.shields.io/github/license/pydantic/pydantic-ai.svg?v" alt="license"></a>
+<div align="center">
+
+![Code Puppy Logo](code_puppy.png)
+
+**🐶✨The sassy AI code agent that makes IDEs look outdated** ✨🐶
+
+[![Version](https://img.shields.io/pypi/v/code-puppy?style=for-the-badge&logo=python&label=Version&color=purple)](https://pypi.org/project/code-puppy/)
+[![Downloads](https://img.shields.io/badge/Downloads-100k%2B-brightgreen?style=for-the-badge&logo=download)](https://pypi.org/project/code-puppy/)
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
+[![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
+[![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/actions)
+[![Coverage](https://img.shields.io/badge/Coverage-95%25-brightgreen?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
+[![Code Style](https://img.shields.io/badge/Code%20Style-Black-black?style=for-the-badge)](https://github.com/psf/black)
+[![Tests](https://img.shields.io/badge/Tests-Passing-success?style=for-the-badge&logo=pytest)](https://github.com/mpfaffenberger/code_puppy/tests)
+
+[![OpenAI](https://img.shields.io/badge/OpenAI-GPT--5-orange?style=flat-square&logo=openai)](https://openai.com)
+[![Gemini](https://img.shields.io/badge/Google-Gemini-blue?style=flat-square&logo=google)](https://ai.google.dev/)
+[![Anthropic](https://img.shields.io/badge/Anthropic-Claude-orange?style=flat-square&logo=anthropic)](https://anthropic.com)
+[![Cerebras](https://img.shields.io/badge/Cerebras-GLM%204.6-red?style=flat-square)](https://cerebras.ai)
+[![Z.AI](https://img.shields.io/badge/Z.AI-GLM%204.6-purple?style=flat-square)](https://z.ai/)
+[![Synthetic](https://img.shields.io/badge/Synthetic-MINIMAX_M2-green?style=flat-square)](https://synthetic.new)
+
+[![100% Open Source](https://img.shields.io/badge/100%25-Open%20Source-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy)
+[![Pydantic AI](https://img.shields.io/badge/Pydantic-AI-success?style=for-the-badge)](https://github.com/pydantic/pydantic-ai)
+
+[![100% privacy](https://img.shields.io/badge/FULL-Privacy%20commitment-blue?style=for-the-badge)](https://github.com/mpfaffenberger/code_puppy/blob/main/README.md#code-puppy-privacy-commitment)
+
+[![GitHub stars](https://img.shields.io/github/stars/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/mpfaffenberger/code_puppy?style=for-the-badge&logo=github)](https://github.com/mpfaffenberger/code_puppy/network)
+
+**[⭐ Star this repo if you hate expensive IDEs! ⭐](#quick-start)**
+
+*"Who needs an IDE when you have 1024 angry puppies?"* - Someone, probably.
+
+</div>
+
+---
+
 
-*"Who needs an IDE?"* - someone, probably.
 
 ## Overview
 
@@ -18,47 +50,145 @@
 
 Code Puppy is an AI-powered code generation agent, designed to understand programming tasks, generate high-quality code, and explain its reasoning similar to tools like Windsurf and Cursor.
 
+
 ## Quick start
 
-`uvx code-puppy -i`
+```bash
+uvx code-puppy -i
+````
 
+## Installation
 
-## Features
+### UV (Recommended)
 
-- **Multi-language support**: Capable of generating code in various programming languages.
-- **Interactive CLI**: A command-line interface for interactive use.
-- **Detailed explanations**: Provides insights into generated code to understand its logic and structure.
+```bash
+# Install UV if you don't have it
+curl -LsSf https://astral.sh/uv/install.sh | sh
 
-## Command Line Animation
+# Set UV to always use managed Python (one-time setup)
+echo 'export UV_MANAGED_PYTHON=1' >> ~/.zshrc  # or ~/.bashrc
+source ~/.zshrc  # or ~/.bashrc
 
-![Code Puppy](code_puppy.gif)
+# Install and run code-puppy
+uvx code-puppy -i
+```
 
-## Installation
+UV will automatically download the latest compatible Python version (3.11+) if your system doesn't have one.
 
-`pip install code-puppy`
+### pip (Alternative)
+
+```bash
+pip install code-puppy
+```
+
+*Note: pip installation requires your system Python to be 3.11 or newer.*
+
+### Permanent Python Management
+
+To make UV always use managed Python versions (recommended):
 
-## Usage
 ```bash
-export MODEL_NAME=gpt-5 # or gemini-2.5-flash-preview-05-20 as an example for Google Gemini models
-export OPENAI_API_KEY=<your_openai_api_key> # or GEMINI_API_KEY for Google Gemini models
-export CEREBRAS_API_KEY=<your_cerebras_api_key> # for Cerebras models
-export YOLO_MODE=true # to bypass the safety confirmation prompt when running shell commands
+# Set environment variable permanently
+echo 'export UV_MANAGED_PYTHON=1' >> ~/.zshrc  # or ~/.bashrc
+source ~/.zshrc  # or ~/.bashrc
 
-# or ...
+# Now all UV commands will prefer managed Python installations
+uvx code-puppy  # No need for --managed-python flag anymore
+```
 
-export AZURE_OPENAI_API_KEY=...
-export AZURE_OPENAI_ENDPOINT=...
+### Verifying Python Version
+
+```bash
+# Check which Python UV will use
+uv python find
 
-code-puppy --interactive
+# Or check the current project's Python
+uv run python --version
 ```
 
-Run specific tasks or engage in interactive mode:
+## Usage
+
+### Custom Commands
+Create markdown files in `.claude/commands/`, `.github/prompts/`, or `.agents/commands/` to define custom slash commands. The filename becomes the command name and the content runs as a prompt.
+
+```bash
+# Create a custom command
+echo "# Code Review
+
+Please review this code for security issues." > .claude/commands/review.md
+
+# Use it in Code Puppy
+/review with focus on authentication
+```
+
+### Adding Models from models.dev 🆕
+
+While there are several models configured right out of the box from providers like Synthetic, Cerebras, OpenAI, Google, and Anthropic, Code Puppy integrates with [models.dev](https://models.dev) to let you browse and add models from **65+ providers** with a single command:
 
 ```bash
-# Execute a task directly
-code-puppy "write me a C++ hello world program in /tmp/main.cpp then compile it and run it"
+/add_model
 ```
 
+This opens an interactive TUI where you can:
+- **Browse providers** - See all available AI providers (OpenAI, Anthropic, Groq, Mistral, xAI, Cohere, Perplexity, DeepInfra, and many more)
+- **Preview model details** - View capabilities, pricing, context length, and features
+- **One-click add** - Automatically configures the model with correct endpoints and API keys
+
+#### Live API with Offline Fallback
+
+The `/add_model` command fetches the latest model data from models.dev in real-time. If the API is unavailable, it falls back to a bundled database:
+
+```
+📡 Fetched latest models from models.dev     # Live API
+📦 Using bundled models database              # Offline fallback
+```
+
+#### Supported Providers
+
+Code Puppy integrates with https://models.dev giving you access to 65 providers and >1000 different model offerings.
+
+There are **39+ additional providers** that already have OpenAI-compatible APIs configured in models.dev!
+
+These providers are automatically configured with correct OpenAI-compatible endpoints, but have **not** been tested thoroughly:
+
+| Provider | Endpoint | API Key Env Var |
+|----------|----------|----------------|
+| **xAI** (Grok) | `https://api.x.ai/v1` | `XAI_API_KEY` |
+| **Groq** | `https://api.groq.com/openai/v1` | `GROQ_API_KEY` |
+| **Mistral** | `https://api.mistral.ai/v1` | `MISTRAL_API_KEY` |
+| **Together AI** | `https://api.together.xyz/v1` | `TOGETHER_API_KEY` |
+| **Perplexity** | `https://api.perplexity.ai` | `PERPLEXITY_API_KEY` |
+| **DeepInfra** | `https://api.deepinfra.com/v1/openai` | `DEEPINFRA_API_KEY` |
+| **Cohere** | `https://api.cohere.com/compatibility/v1` | `COHERE_API_KEY` |
+| **AIHubMix** | `https://aihubmix.com/v1` | `AIHUBMIX_API_KEY` |
+
+#### Smart Warnings
+
+- **⚠️ Unsupported Providers** - Providers like Amazon Bedrock and Google Vertex that require special authentication are clearly marked
+- **⚠️ No Tool Calling** - Models without tool calling support show a big warning since they can't use Code Puppy's file/shell tools
+
+### Durable Execution
+
+Code Puppy now supports **[DBOS](https://github.com/dbos-inc/dbos-transact-py)** durable execution.
+
+When enabled, every agent is automatically wrapped as a `DBOSAgent`, checkpointing key interactions (including agent inputs, LLM responses, MCP calls, and tool calls) in a database for durability and recovery.
+
+You can toggle DBOS via either of these options:
+
+- CLI config (persists): `/set enable_dbos true` (or `false` to disable)
+
+
+Config takes precedence if set; otherwise the environment variable is used.
+
+### Configuration
+
+The following environment variables control DBOS behavior:
+- `DBOS_CONDUCTOR_KEY`: If set, Code Puppy connects to the [DBOS Management Console](https://console.dbos.dev/). Make sure you first register an app named `dbos-code-puppy` on the console to generate a Conductor key. Default: `None`.
+- `DBOS_LOG_LEVEL`: Logging verbosity: `CRITICAL`, `ERROR`, `WARNING`, `INFO`, or `DEBUG`. Default: `ERROR`.
+- `DBOS_SYSTEM_DATABASE_URL`: Database URL used by DBOS. Can point to a local SQLite file or a Postgres instance. Example: `postgresql://postgres:dbos@localhost:5432/postgres`. Default: `dbos_store.sqlite` file in the config directory.
+- `DBOS_APP_VERSION`: If set, Code Puppy uses it as the [DBOS application version](https://docs.dbos.dev/architecture#application-and-workflow-versions) and automatically tries to recover pending workflows for this version. Default: Code Puppy version + Unix timestamp in millisecond (disable automatic recovery).
+
+
 ## Requirements
 
 - Python 3.11+
@@ -68,10 +198,6 @@ code-puppy "write me a C++ hello world program in /tmp/main.cpp then compile it
 - Anthropic key (for Claude models)
 - Ollama endpoint available
 
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
 ## Agent Rules
 We support AGENT.md files for defining coding standards and styles that your code should comply with. These rules can cover various aspects such as formatting, naming conventions, and even design guidelines.
 
@@ -81,8 +207,6 @@ For examples and more information about agent rules, visit [https://agent.md](ht
 
 Use the `/mcp` command to manage MCP (list, start, stop, status, etc.)
 
-In the TUI you can click on MCP settings on the footer and interact with a mini-marketplace.
-
 Watch this video for examples! https://www.youtube.com/watch?v=1t1zEetOqlo
 
 
@@ -594,8 +718,28 @@ Consider contributing agent templates for:
 
 ---
 
-**Happy Agent Building!** 🚀 Code Puppy now supports both Python and JSON agents, making it easy for anyone to create custom AI coding assistants! 🐶✨
+# Code Puppy Privacy Commitment
+
+**Zero-compromise privacy policy. Always.**
+
+Unlike other Agentic Coding software, there is no corporate or investor backing for this project, which means **zero pressure to compromise our principles for profit**. This isn't just a nice-to-have feature – it's fundamental to the project's DNA.
+
+### What Code Puppy _absolutely does not_ collect:
+- ❌ **Zero telemetry** – no usage analytics, crash reports, or behavioral tracking
+- ❌ **Zero prompt logging** – your code, conversations, or project details are never stored
+- ❌ **Zero behavioral profiling** – we don't track what you build, how you code, or when you use the tool
+- ❌ **Zero third-party data sharing** – your information is never sold, traded, or given away
+
+### What data flows where:
+- **LLM Provider Communication**: Your prompts are sent directly to whichever LLM provider you've configured (OpenAI, Anthropic, local models, etc.) – this is unavoidable for AI functionality
+- **Complete Local Option**: Run your own VLLM/SGLang/Llama.cpp server locally → **zero data leaves your network**. Configure this with `~/.code_puppy/extra_models.json`
+- **Direct Developer Contact**: All feature requests, bug reports, and discussions happen directly with me – no middleman analytics platforms or customer data harvesting tools
 
+### Our privacy-first architecture:
+Code Puppy is designed with privacy-by-design principles. Every feature has been evaluated through a privacy lens, and every integration respects user data sovereignty. When you use Code Puppy, you're not the product – you're just a developer getting things done.
 
-## Conclusion
-By using Code Puppy, you can maintain code quality and adhere to design guidelines with ease.
+**This commitment is enforceable because it's structurally impossible to violate it.** No external pressures, no investor demands, no quarterly earnings targets to hit. Just solid code that respects your privacy.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

code_puppy-0.0.314/code_puppy/__init__.py

@@ -0,0 +1,10 @@
+import importlib.metadata
+
+# Biscuit was here! 🐶
+try:
+    _detected_version = importlib.metadata.version("code-puppy")
+    # Ensure we never end up with None or empty string
+    __version__ = _detected_version if _detected_version else "0.0.0-dev"
+except Exception:
+    # Fallback for dev environments where metadata might not be available
+    __version__ = "0.0.0-dev"