Biopoiesis

The lightest AI application framework. One Python process, one YAML config, one plugin directory.

最轻量级 AI 应用开发框架。一个 Python 进程，一个 YAML 配置，一个插件目录。

Quick Start

1. Install

pip install biopoiesis

2. Configure

Copy config/robots.example.yaml to config/robots.yaml, fill in your API key.

3. Run

biopoiesis

API gateway at http://127.0.0.1:9000.

4. Create your first plugin

biopoiesis --create-plugin hello

restart, then test:

curl -X POST http://127.0.0.1:9000/api/hello -H "Content-Type: application/json" -d '{"content":"Hello"}'

$body = '{"content":"Hello"}'
Invoke-RestMethod -Uri http://127.0.0.1:9000/api/hello -Method POST -ContentType "application/json" -Body $body

5. Examples

Full examples guide →

Architecture

Three-tier usage, from simple to complex:

API

Plugin Development

# plugins/my_plugin.py

async def execute(envelop, cancel_checker):
    llm = cancel_checker.llm if cancel_checker else None
    result = await llm.chat([{"role": "user", "content": envelop.payload.get("content")}])
    envelop.payload = {"result": result}
    return envelop

def on_load(system, app):
    from aiohttp import web
    async def handler(request):
        data = await request.json()
        result = await execute(AICPEnvelop(payload=data), system)
        return web.json_response({"ok": True, "data": result.payload})
    app.router.add_post('/api/my_plugin', handler)

Note: After updating a plugin, restart the framework for changes to take effect.

注意: 更新插件后需重启框架才能生效。

Dependencies

• Python >= 3.10
• openai >= 2.0
• PyYAML >= 6.0
• aiohttp >= 3.9

License

MIT — see LICENSE for details.