Metadata-Version: 2.4
Name: magiccode123
Version: 1.1.0
Summary: A terminal AI coding assistant with ReAct-style tool use.
Author: Tingfeng347
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,cli,coding-assistant,react
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Terminals
Requires-Python: >=3.12
Requires-Dist: openai>=2.30.0
Description-Content-Type: text/markdown

# MagicCode

MagicCode 是一个终端 AI 编码助手示例，使用 OpenAI 兼容接口和 ReAct 风格循环，让模型可以在对话中调用本地 shell 工具。

## 安装

```bash
pip install magiccode
```

开发环境可以直接用 uv 运行：

```bash
uv run magiccode
```

## 配置

发布版本不会内置 API key。运行前请设置环境变量：

```bash
export MAGICCODE_API_KEY="你的 API key"
```

可选配置：

```bash
export MAGICCODE_BASE_URL="http://183.147.142.111:30000/v1"
export MAGICCODE_MODEL="glm-4.7"
```

也可以使用 `OPENAI_API_KEY` 作为备用变量。

## 使用

```bash
magiccode
```

进入交互模式后：

- 输入问题或任务开始对话
- 输入 `clear` 清空历史
- 输入 `exit` 或 `quit` 退出

## 构建与发布

本项目使用标准 `pyproject.toml` 元数据和 Hatchling build backend。使用 uv 构建：

```bash
uv build
```

发布到 TestPyPI：

```bash
uv publish --publish-url https://test.pypi.org/legacy/ --token "$TEST_PYPI_TOKEN"
```

发布到 PyPI：

```bash
uv publish --token "$PYPI_TOKEN"
```
