InKCre Python Implementation

The Python peer of InKCre. Owns the authoritative database schema and migrations, hosts the inkcre-cli, and ships Python-implemented first-party extensions.

impl-py 是 InKCre 的 Python 实现——一个持有数据库 schema 权威的 peer，同时承载命令行工具和一方 Python 扩展。

Quickstart

Self-host an InKCre instance

You do not need to clone this repository. Fork it on GitHub, configure the documented secrets, and run the checked-in self-host workflow:

• Render + Neon
• Heroku + Neon

Develop locally

git submodule update --init --recursive
pdm install -G dev --frozen-lockfile
svc dev ensure database --repo . --json
pdm run dev

The full validation gate used by CI is pdm run check. See CONTRIBUTING.md for setup, migrations, and delivery details.

Documentation

• Documentation index
• Agent operating guide
• Deployment and runtime truth
• Local unit design
• Shared product truth Hub: InKCre/docs (mounted read-only at docs/_shared/)

Security

Report vulnerabilities privately through SECURITY.md. Security design follows the shared Security Boundary Model and the local runtime projection.

Generated artifacts

• OpenAPI schema: docs/openapi.json (regenerate with pdm run python scripts/generate-openapi.py)
• This repository does not publish hosted API documentation automatically