fastkeel ⚡

FastAPI backend scaffold — user auth, social, subscriptions, jobs & LLM. pip install fastkeel，一行命令生成完整后端骨架。

Status: v0.1.0 — 生产就绪，MIT 开源。

快速开始

# 安装
pip install fastkeel

# 生成项目
fastkeel new my-app --with-user --with-social --with-payment --with-jobs
cd my-app

# 安装依赖并启动
pip install uvicorn
python main.py

生成的项目直接可用：注册、登录、搭子关系、支付订阅、定时任务 — 一个 main.py 全搞定。

CLI 用法

fastkeel new <项目名> [--with-user] [--with-social] [--with-payment] [--with-jobs] [--path <路径>]

不选的模块不注册路由、不创建表、不引入依赖。

模块

架构

你的项目
├── main.py          # import fastkeel → compose app
├── config.toml      # TOML 配置（环境变量覆盖）
├── project/         # 你的业务逻辑
│   ├── routes/
│   ├── logic/
│   └── prompts/
└── tests/

        │ pip install fastkeel
        v
fastkeel (this repo)
├── core/            # 100% 通用，不修改
├── modules/         # 90% 通用，include_*() 选装
├── contrib/         # 扩展集成，按需 import
└── cli/             # fastkeel new 命令

分层规则：

• core/ — 项目永不修改。需要改意味着抽象边界要调整
• modules/ — 通过 config 配置，不修改源码
• project/ — 写业务逻辑的地方

开发

# Setup
git clone https://github.com/helioswei/fastkeel
cd fastkeel
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Commands
make lint           # ruff check .
make test           # pytest
make build          # python -m build
make publish        # build + twine upload

# Test single file
pytest tests/test_modules/test_user.py -v

测试 (122 tests, 1.5s)

Roadmap

• PyPI release — python -m build && twine upload dist/*
• user_extra_fields dynamic columns — ALTER TABLE ADD COLUMN from config
• End-to-end generated project test — fastkeel new → pip install → serve → curl
• Webhook signature verification — validate payment_webhook_secret

MIT © 2026 Helioswei