WACP Python SDK (wacp)

Version: 2.0.0

pip install wacp

One package for Python. Framework adapters live in submodules:

from wacp.fastapi import wacp_router
# later: from wacp.flask import ...
# later: from wacp.django import ...

Full changelog: ../CHANGELOG.md

Quick start (FastAPI)

from fastapi import FastAPI
from wacp.fastapi import wacp_router

app = FastAPI()

# ... your normal routes ...

app.include_router(
    wacp_router(
        app,
        base_dir="ai",       # folder with config/ + docs/
        discover=True,       # optional: write config/_discovered.json
    )
)

If ai/config/ does not exist, the SDK auto-scaffolds starter JSON files on first boot.

Package layout

wacp/
  core/          # config, scaffold, search, types (shared)
  fastapi/       # FastAPI adapter (wacp_router, discovery)
  # flask/       # planned
  # django/      # planned

base_dir layout

ai/
  config/
    main.json
    categories.json
    endpoints.json
    docs.json
    custom-map.json
    _discovered.json        # only when discover=True (never served / never merged)
  docs/
    overview.md

Optional: set files.search_vocabulary in main.json to a JSON file under config/ for org-specific synonym overrides.

Routes

Discovery (discover=True)

from wacp.fastapi import wacp_router, FastAPIDiscovery

• Writes base_dir/config/_discovered.json
• Never served by /ai, never merged into endpoints.json
• Scaffold runs before discovery on a fresh base_dir

Search & pagination

Lightweight lexical search via GET /ai/search?q=....
List routes accept optional ?page=&limit=.

Versioning

2.0.0 — see CHANGELOG and wacp.__version__.

License

MIT