Tidepool

无需离开命令行即可构建和部署任何类型的Web应用。专为自主AI代理设计。开箱即用，支持认证、Stripe支付、管理面板、电子邮件、数据库、文件存储、自定义域名、Markdown、密钥以及实时SSE（聊天应用/在线游戏）。极简主义方法。

适用场景：用户想要创建网站、部署Python Web应用、添加订阅或付费墙、设置用户登录，或构建任何带有URL的内容。提供tidepool CLI和tp.*运行时API。秒级部署，可扩展到10个以上副本。不适用于：非Web任务、通用Python脚本。

学习API

在构建任何内容之前，先获取完整的API参考：

bash
curl -s https://tidepool.sh/api | python3 -m json.tool

这将返回每个端点、每个tp.*运行时工具以及使用示例。请先阅读。

工作流程

一条命令从零到上线Substack克隆版：
bash
pip install tidepool && tidepool quickstart

或者从头开始构建：
bash
tidepool init my-app && cd my-app

编辑 main.py

tidepool dev # 本地开发服务器 http://localhost:8000
tidepool register --email you@example.com
tidepool deploy # 上线地址 https://my-app.tidepool.sh

在运行中的Pod上迭代：
bash
tidepool pull # 拉取Pod代码+数据到本地工作
tidepool dev # 本地测试更改
tidepool push # 将代码、数据库、密钥、文件推送回生产环境
tidepool push --secret STRIPEKEY=skxxx # 覆盖密钥
tidepool push --replace-db # 替换所有数据库键而非合并
tidepool push --sync # 同时删除本地不存在的远程文件
tidepool push -y # 跳过确认提示

运行时（import tp）

main.py在启动时运行一次，用于注册路由和配置应用。服务器将请求分派给处理函数。

python
import tp

tp.auth = standard # 邮箱/密码认证
tp.payments = {products: [{id: pro, name: Pro, price: 500, recurring: month}]}
tp.admin = {users: [admin@example.com]}

@tp.route(/)
def home(req):
posts = tp.db.prefix(post:, reverse=True, limit=10)
return render_posts(posts, req.user)

@tp.route(/post/:slug, methods=[GET, POST])
def post(req, slug):
if req.method == POST:
tp.db.set(fpost:{slug}, req.body)
return None # 303重定向
return tp.db.get(fpost:{slug})

处理函数返回值： str → HTML，dict → JSON，int → 状态码，None → 重定向，tuple → (响应体, 状态码)，生成器 → SSE。

请求对象： req.path、req.method、req.query、req.user、req.body、req.files。

关键工具

工具	用法
tp.route(path)	@tp.route(/api/:id, methods=[GET,POST])
tp.page(path, html)

tp.page(/about,

关于

) | | tp.auth | standard、paywall 或配置字典 | | tp.payments | {products: [{id, name, price, recurring}]} | | tp.admin | {users: [admin@x.com], models: {...}} | | tp.db | .get(k)、.set(k,v)、.delete(k)、.prefix(p)、.keys()、.count() | | tp.files | .read(name)、.write(name, data)、.list()、.delete(name) | | tp.email() | tp.email(to@x.com, 主题, 正文, html=

你好

) | | tp.http | tp.http.get(url)、.post(url, json={}) | | tp.secrets | 来自 tp_data/secrets.json 的只读字典 | | tp.state | 公共JSON状态，可通过 ?format=json 读取 | | tp.background() | @tp.background(seconds=3600) 用于定时任务 | | tp.markdown() | 将Markdown字符串转换为HTML | | tp.createuser() | tp.createuser(邮箱, 密码, subscriptions={}) | | tp.users() | 返回所有用户（排除密码哈希） | | tp.publish() | tp.publish({messages: msgs}) — 更新公共JSON状态（ETag轮询） |

注意事项

• - 本地开发将数据存储在 tpdata/ 中（db.json、secrets.json、files/）。
• 密钥放在 tpdata/secrets.json 中 — 运行时为只读。
• static/ 中的静态文件通过 /static/ 提供服务。
• 预装了Jinja2用于模板渲染。
• tidepool eject 将运行时文件复制到项目中，以便完全控制。