Ditto

Ditto - 最简单的自动生成代码的智能体。

Ditto 是一款用户友好的工具，它允许您通过无代码界面，仅使用简单的自然语言描述即可生成一个多文件的 Flask 应用程序。借助一个包含少量工具的简单 LLM 循环，Ditto 能够自动化编码过程，（偶尔）将您的想法转化为可用的 Web 应用程序（或者至少会尝试并尽可能接近目标）。

特性

• 简单的自然语言输入：只需用通俗易懂的英语描述您想要构建的应用程序。
• 自动化代码生成：根据您的描述生成路由、模板和静态文件。
• 自动生成代理：无需手动编码即可自动规划并构建应用程序。
• 模块化结构：将代码组织成整洁的模块化结构，分别设有模板、静态文件和路由的独立目录。

快速开始

前置条件

• Python 3.7 或更高版本
• pip 包管理器

安装

1. 克隆仓库

   git clone https://github.com/yoheinakajima/ditto.git
   cd ditto
   

2. 创建虚拟环境（可选但推荐）

   python3 -m venv venv
   source venv/bin/activate  # 在 Windows 上，请使用 venv\\Scripts\\activate
   

3. 安装依赖

   pip install litellm
   

设置 OPENAI_API_KEY

要使用 Ditto，您需要在环境中设置 OPENAI_API_KEY。以下是两种设置方法：

方法 1：终端临时设置

对于 macOS/Linux：

export OPENAI_API_KEY=your-openai-api-key

对于 Windows（命令提示符）：

set OPENAI_API_KEY=your-openai-api-key

对于 Windows（PowerShell）：

$env:OPENAI_API_KEY="your-openai-api-key"

然后运行应用程序：

python main.py

方法 2：使用 .env 文件持久化设置（推荐）

1. 安装 python-dotenv 包，以便从 .env 文件加载环境变量：

   pip install python-dotenv
   

2. 在项目根目录下创建一个 .env 文件，并添加您的 API 密钥：

   OPENAI_API_KEY=your-openai-api-key
   

3. 正常运行应用程序：

   python main.py
   

使用

1. 运行应用程序

   python main.py
   

2. 访问 Web 界面

   打开您的浏览器，访问 http://localhost:8080。

3. 描述您的应用

   在首页上，您会看到一个表单，可以在其中描述您想要创建的 Flask 应用程序。

4. 监控进度

   提交描述后，应用程序将处理您的请求。您可以实时监控进度。

5. 查看生成的应用

   进程完成后，您可以重新运行 Flask 应用程序，以与您新生成的 Flask 应用程序进行交互。

   python main.py
   

贡献

这只是一个快速的探索项目，因此我暂时没有进一步开发的计划。欢迎贡献，尤其是那些非常棒的贡献，不过请先在 X/Twitter 上联系我，因为我并不经常查看 Pull Request。我基本上打算将这个功能整合到新的 BabyAGI 框架 中，但会赋予它从数据库中存储和保存函数的能力。如果这听起来是个有趣的挑战，并且您成功实现了它，请务必告诉我 :)

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

Ditto 快速上手指南

Ditto 是一个极简的自构建编码代理工具。它允许用户通过无代码界面，仅用自然语言描述即可生成多文件的 Flask 应用程序。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：macOS、Linux 或 Windows
• Python 版本：Python 3.7 或更高版本
• 包管理器：已安装 pip
• API 密钥：需要有效的 OpenAI API Key (OPENAI_API_KEY)

安装步骤

1. 克隆项目

打开终端，执行以下命令获取源代码：

git clone https://github.com/yoheinakajima/ditto.git
cd ditto

2. 创建虚拟环境（推荐）

为了避免依赖冲突，建议创建独立的虚拟环境：

python3 -m venv venv
source venv/bin/activate  # Windows 用户使用：venv\Scripts\activate

3. 安装依赖

安装核心依赖库 litellm。如需使用 .env 文件配置密钥，也请一并安装 python-dotenv：

pip install litellm python-dotenv

提示：国内用户若下载缓慢，可添加清华源加速： pip install litellm python-dotenv -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 配置 API 密钥

方式一：使用 .env 文件（推荐） 在项目根目录创建名为 .env 的文件，并填入以下内容：

OPENAI_API_KEY=your-openai-api-key

请将 your-openai-api-key 替换为您真实的 OpenAI 密钥。

方式二：临时环境变量 或者直接在终端设置环境变量（仅当前会话有效）：

macOS/Linux:

export OPENAI_API_KEY=your-openai-api-key

Windows (PowerShell):

$env:OPENAI_API_KEY="your-openai-api-key"

基本使用

1. 启动应用

在终端运行主程序：

python main.py

2. 访问界面

打开浏览器，访问地址： http://localhost:8080

3. 生成应用

• 在首页表单中，用简单的英语描述您想要构建的 Flask 应用（例如："A todo list app with add and delete functions"）。
• 提交描述后，Ditto 将自动规划并生成代码（包括路由、模板和静态文件）。
• 您可以实时查看生成进度。

4. 运行生成的应用

生成完成后，再次运行 python main.py（或根据生成的文件结构运行新生成的 Flask 应用），即可与您刚刚创建的 Web 应用进行交互。