diff --git a/README.md b/README.md
index e69de29..6084ee2 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,57 @@
+# chongming Core
+
+基于 FastAPI 的微服务网关脚手架，集成 Zenoh、Worker 框架、动态路由、模块银行何对象存储。
+
+## 核心特性
+
+- **FastAPI + Uvicorn**：高性能异步 Web 框架
+- **Zenoh 服务发现**：基于 Zenoh 的 Worker 注册与 RPC 调用
+- **动态路由生成**：根据 `config/workers` 下的 TOML 配置自动生成 API 端点
+- **Worker 框架**：使用 `@rpc_method` 装饰器定义 RPC 方法，支持自动生成 Pydantic 模型
+- **模块银行（module-bank）**：将 Python 模块加密打包为 SQLite 数据库，支持动态导入
+- **对象存储代理**：集成 `nanio` （S3 兼容）文件上传/下载
+- **构建打包**：支持 PyInstaller / Nuitka 一键打包为独立可执行文件
+
+## 项目结构
+
+```text
+.
+├── config/ # 配置文件目录
+│ ├── workers/ # Worker 路由配置
+│ └── zenoh_config.json5 # Zenoh 配置
+├── public/ # 公共启动文件（main.py, server.py）
+├── src/
+│ ├── chongming/ # 核心应用
+│ │ ├── app/ # FastAPI 应用、路由、核心组件
+│ │ └── scripts/ # 工具脚本（build, gen_models）
+│ └── plugins/ # Worker 插件源码
+├── utils/ # 子工具包（worker, request, jwt）
+├── build_nuitka/ # Nuitka 打包配置示例
+└── pyproject.toml # 项目依赖与工具配置
+```
+
+## 快速开始
+
+1. 安装依赖 （推荐使用 uv）
+
+```bash
+uv sync
+```
+
+2. 启动服务（开发模式）
+
+```bash
+uv run serve
+```
+
+3. 访问 API 文档：`http://localhost:8000/docs`
+
+## 构建
+
+- PyInstaller：`uv run build pyinstaller`
+- Nuitka：`uv run build nuitka`
+
+## 更多文档
+
+- Worker 开发指南（待补充）
+- [配置说明](http://124.71.68.6:3000/chongming/chongming-config.git/README.md)