Metadata-Version: 2.4
Name: codecat
Version: 0.4
Summary: CodeCat: AI-Powered Python Agent Framework
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: brotli>=1.2.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: anthropic>=0.49.0
Requires-Dist: beautifulsoup4>=4.13.3
Requires-Dist: dynaconf>=3.2.10
Requires-Dist: openai>=1.68.2
Requires-Dist: prompt-toolkit>=3.0.51
Requires-Dist: requests>=2.32.3
Requires-Dist: rich>=13.9.4
Requires-Dist: tomli-w>=1.2.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: questionary>=2.1.0
Requires-Dist: mcp[cli]>=1.21.0
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: jinja2>=3.1.6
Requires-Dist: markdownify>=1.2.0
Requires-Dist: charset-normalizer>=3.4.2
Requires-Dist: promptabs>=0.3.1
Requires-Dist: websockets>=14.0
Requires-Dist: socksio>=1.0.0
Requires-Dist: pysocks>=1.7.1
Requires-Dist: tree-sitter>=0.23.0
Requires-Dist: tree-sitter-python>=0.23.0
Requires-Dist: tree-sitter-javascript>=0.23.0
Provides-Extra: http
Requires-Dist: fastapi>=0.116.1; extra == "http"
Requires-Dist: uvicorn>=0.38.0; extra == "http"
Provides-Extra: apps
Requires-Dist: fastapi>=0.116.1; extra == "apps"
Requires-Dist: uvicorn>=0.38.0; extra == "apps"
Dynamic: license-file


# CodeCat: AI-Powered Python Agent Framework

**AI-Powered Python & Python-Powered AI**

CodeCat is a task-driven, result-oriented intelligent execution framework. It tightly integrates LLMs with a Python interpreter to establish a complete loop:

> **Task → Plan → Code → Execute → Feedback**

## Background: The Outdated "Prosthetic" AI Agent Model

Traditional AI (Agent 1.0) relies on Function Calling, Tools, MCP-Servers, Workflows, and plugin-based clients. These external "prosthetics" lead to:
- High entry barriers
- Heavy reliance on developers
- Poor coordination between tools
- Most AI-generated code locked in cloud sandboxes, unable to interact with the real environment

We urgently need a new paradigm that reconnects AI with the real world and fully activates its native execution power—ushering in the **AI Think Do** era.

## What is CodeCat?

CodeCat provides the entire Python execution environment to LLM. Imagine LLM sitting in front of a computer, typing various commands into the Python command-line interpreter, pressing Enter to execute, observing the results, and then typing and executing more code.

This gives models two core capabilities:
- **API Calling**: Automatically generate and execute Python code to invoke APIs
- **Packages Calling**: Flexibly leverage Python's ecosystem to orchestrate workflows

Users only need to provide a task description or API key. The model handles the rest—no plugin registration, no toolchain setup, no workflow editing.

> **Important**: CodeCat is _not_ a code generator or smart IDE.
> It's a task-first, outcome-driven AI Agent.

To the user, CodeCat is simple:
> Describe a task → AI executes it → Result returned.

The model autonomously understands, plans, writes, debugs, and executes code—and fixes bugs along the way. Code is just an internal implementation—not the deliverable. The real deliverable is the **result**.

## Why Python?

While this paradigm theoretically supports any language, we choose Python because:
- It has a powerful ecosystem spanning data, automation, system control, and AI
- Its syntax is simple and readable, ideal for model generation and debugging
- Models are naturally more proficient in Python for accurate and efficient coding

## Core Principle: No Agents, Code is Agent

CodeCat introduces a radically simplified execution architecture:

**No Agents, No MCP, No Workflow, No Clients…**

It discards legacy layers and lets models use code to directly act on the environment. In short: **Code is Agent**.

With Python, the model can:
- **Python use Data**: Load, transform, analyze
- **Python use Browser**: Automate the web
- **Python use Computer**: Access file systems and local resources
- **Python use IoT**: Control devices and embedded systems
- **…**
- **Python use Anything**: Code becomes a universal interface

This means:
- **No MCP**: No standardized protocol needed—code is the protocol
- **No Workflow**: Model plans and executes on the fly
- **No Tools**: No plugin registrations needed—just use existing ecosystems
- **No Agents**: Code replaces orchestration—execution becomes native

This is the bridge that reconnects LLMs to the real digital world, unlocking their latent power.

## Execution Mode: AI Think Do

**AI Think Do = True Integration of Knowing & Doing**

- **Task**: User describes intent
- **Plan**: Model decomposes and plans a path
- **Code**: Optimal Python strategy is generated
- **Execute**: Direct interaction with the environment
- **Feedback**: Output is evaluated and looped back into planning

No external agent needed. The AI completes the full loop independently, unleashing true cognitive-action capability.

## Single Entry Point: CodeCat

You don't need multiple AI apps or UI wrappers anymore.

Just run one thing: **CodeCat**, a Python-powered AI Client.

- **Unified interface**: All interaction via Python
- **Zero clutter**: No plugin mess, no bloated clients

## Usage

CodeCat has two running modes:

### Task Mode (Default)
Very simple and easy to use—just input your task. Suitable for users unfamiliar with Python.

```bash
codecat
```

### HTTP Mode
Run CodeCat as an HTTP task service with API key authentication and SSE task events.

- [HTTP Server Configuration](docs/http-server.md)
- [HTTP API Reference](docs/http-api.md)
- [Docker](docs/docker.md)

## Basic Config

Create `~/.codecat/config.toml`:

```toml
[llm.deepseek]
type = "deepseek"
api_key = "Your DeepSeek API Key"
```

CodeCat uses a single main user configuration file:

```text
~/.codecat/config.toml
```

CLI and GUI configuration flows write LLM settings into this file under the
`[llm]` section.

For configuration paths, loading rules, supported sections, and complete
examples, see the [configuration guide](docs/configuration.zh.md).

## Task Mode Examples

### Installation
```bash
pip install codecat
```

### Usage
```bash
codecat
```

```
🚀 CodeCat (0.1.22)
>>> Get the latest posts from Reddit r/LocalLLaMA
......
>>> /done
```

### Basic Config
~/.codecat/config.toml:
```toml
[llm.deepseek]
type = "deepseek"
api_key = "Your DeepSeek API Key"
```

### Task Mode
`uv run codecat`
```
>>> Get the latest posts from Reddit r/LocalLLaMA
......
>>> /done
```

`pip install codecat` and run with `codecat`

```
-> % codecat
🚀 CodeCat (0.1.22)
>> Get the latest posts from Reddit r/LocalLLaMA
......
>>
```

## Vision: Free the AI, Reach AGI

CodeCat is more than a tool—it's a future-facing AI philosophy:

> **The Model is the Product → The Model is the Agent → No Agents, Code is Agent → Just Python-use → Freedom AI (AGI)**

It transforms AI from "just speaking" to "taking action," from plugin-bound to autonomous execution. It unlocks full production power—and lights the path to general intelligence.

Join us. Let AI break free, act freely, and build the future.

**The real general AI Agent is NO Agents!**

**No Agents, Just Python-use!**

## Self-Evolution: Multi-Model Fusion

AI evolution is not just language modeling—it's multi-modal intelligence.

- Integrates vision models for image/video understanding
- Adds speech models for listening and speaking
- Embeds expert models for domain reasoning
- All fused and coordinated under a unified AI control loop

This moves us from "chatbots" to fully embodied AI agents—on the path to true AGI.

## Thanks

- **Hei Ge**: Product manager/senior user/chief tester
- **Sonnet 3.7**: Generated the first version of the code, which was almost ready to use without modification
- **ChatGPT**: Provided many suggestions and code snippets, especially for the command-line interface
- **Codeium**: Intelligent code completion
- **Copilot**: Code improvement suggestions

---

**CodeCat: The Future of AI Agents**
