code-puppy
Code generation agent
Decision gist · record as of 2026-08-14
Yes, if you want a lightweight, open-source AI code agent with multi-provider LLM support and low install friction. The active maintenance, permissive MIT license, and broad provider integration make it a viable alternative to commercial tools. Install with caution on Android (Termux) due to compilation time and missing browser tools. Verify that your preferred LLM provider is supported and that you have valid API credentials before committing to it as your primary coding assistant.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later.
- First run may compile native dependencies (especially on Android/Termux).
- Playwright-backed browser tools are not available on Android.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions. You may use, modify, and distribute this package freely provided you retain the license notice.
last release 2026-08-14 (0 days) · last repo commit 2026-08-14 · 787 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,003 downloads/mo, #14,891 on PyPI
Alternatives
Verify before relying
# Install via UV (recommended)
uvx code-puppy -i
# Or via pip
pip install code-puppy
# Run interactively
code-puppy
# Then configure an API key (e.g., OpenAI):
# export OPENAI_API_KEY="sk-..."
# and use /add_model to browse and add models from providers- How many providers are actually available through models.dev integration and which are thoroughly tested versus experimental.
- Performance and stability when running multiple concurrent agent instances.
- Whether the optional DBOS durable-execution plugin is production-ready and what database backends are recommended.
What it is and what it does
Code Puppy is a terminal-based AI code agent that acts as an alternative to commercial code editors. It connects to multiple LLM providers (OpenAI, Anthropic, Google, and others via models.dev) and uses tool calling to read files, execute shell commands, and generate code interactively. The agent understands programming tasks, generates code, and explains its reasoning in a conversational interface.
You interact with Code Puppy through a command-line REPL with slash commands (e.g., `/add_model` to browse and configure new LLM providers, `/meta-auth` for Meta OAuth, `/dbos` for optional durable execution). It supports custom commands via markdown files in project directories and can optionally checkpoint agent state to a database for crash recovery. The package is designed to be lightweight and scriptable, with low install friction via pure-Python distribution.
Use it for
- Generate and refactor code interactively by describing tasks to an AI agent with access to your project files and shell.
- Experiment with multiple LLM providers and models without switching tools, using the integrated models.dev browser.
- Run long-running code-generation tasks with automatic crash recovery by enabling optional DBOS durable execution.
- Extend Code Puppy with custom slash commands by dropping markdown files into project directories.
- Use as a scriptable alternative to GUI-based code editors for CI/CD pipelines or headless environments.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you want a lightweight, open-source AI code agent with multi-provider LLM support and low install friction.
The active maintenance, permissive MIT license, and broad provider integration make it a viable alternative to commercial tools. Install with caution on Android (Termux) due to compilation time and missing browser tools. Verify that your preferred LLM provider is supported and that you have valid API credentials before committing to it as your primary coding assistant.
Install
code-puppy on PyPI
Before you install
Low install friction with a pure-Python wheel distribution. Active maintenance as of 2026-08-14 with 787 repository stars. Requires Python 3.11–3.14 and 23 runtime dependencies including anthropic, openai, boto3, and playwright, which may add setup time on first install.
Requires Python 3.11 or later. First run may compile native dependencies (especially on Android/Termux). Playwright-backed browser tools are not available on Android. API keys for at least one LLM provider (OpenAI, Anthropic, etc.) are required to generate code.
License in practice
MIT license permits commercial and private use with minimal restrictions. You may use, modify, and distribute this package freely provided you retain the license notice.
Quickstart
# Install via UV (recommended)
uvx code-puppy -i
# Or via pip
pip install code-puppy
# Run interactively
code-puppy
# Then configure an API key (e.g., OpenAI):
# export OPENAI_API_KEY="sk-..."
# and use /add_model to browse and add models from providersVerify before relying
- How many providers are actually available through models.dev integration and which are thoroughly tested versus experimental.
- Performance and stability when running multiple concurrent agent instances.
- Whether the optional DBOS durable-execution plugin is production-ready and what database backends are recommended.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <3.15,>=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 23 packagesagent-client-protocolanthropicazure-identityboto3code-puppy-core-pluginshttpxjson-repairkeyringmcpopenaipillowplaywrightprompt-toolkitpydantic-ai-slimpydanticpyfigletpython-dotenvrapidfuzzrequestsrichripgreptermflow-mdtyper |
| Maintenance | Actively maintained 0 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 74,003 / month, #14,891 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Software Development :: Code Generators |
Evidence: code_puppy-0.0.718-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “llm-powered coding assistant”
- code-puppyCode Puppy is an AI-powered code generation agent that understands…
- deepagents-codeA terminal-based AI coding agent that works with any LLM supporting…
- openhandsOpenHands is a CLI tool that runs an AI agent in your terminal, IDE,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Code Generators packages
Proto Plus wraps protocol buffers to provide Python classes that behave like native Python types while maintaining protocol buffer serialization and schema validation.
Install it if you're working with protocol buffers in Python and want a more Pythonic interface, or if you're using Google Cloud libraries that depend on it.
Cython is a source code translator that compiles Python code to C, enabling optional static typing and direct C/C++ interoperability to generate efficient native extensions.
Install it if you need to optimize Python performance, wrap C/C++ libraries, or build fast native extensions.
Annotates Python abstract syntax trees with the positions of tokens and source code text, enabling tools to map AST nodes back to their originating code for refactoring, analysis, and transformation.
Beartype is a runtime type checker that validates Python type hints at function call time, catching type violations before they cause downstream bugs.
Install it if you want runtime type safety for your annotated code or need to validate type hints on third-party packages.
llvmlite provides a lightweight Python binding to LLVM's IR builder, optimizer, and JIT compiler APIs, enabling you to write JIT compilers and code generators without needing the full LLVM C++ API surface.
astor converts Python abstract syntax trees (ASTs) back to readable source code and provides tools for AST manipulation, inspection, and non-recursive tree traversal.
Install it if you need AST round-tripping or advanced tree inspection.
See also trinity-agent · opencode-agent-hub · ouroboros-ai · deepagents-code · mini-swe-agent · graphifyy · skillsaw · agentops · headroom-ai · semble