WACP (Web Agent Client Protocol) Python SDK (wacp)

Version: 2.0.4

pip install wacp

One package, all frameworks. Same function name everywhere:

from wacp.fastapi import wacp_router   # FastAPI
from wacp.flask import wacp_router     # Flask
from wacp.django import wacp_router    # Django

Only pydantic is installed as a dependency. Your framework (fastapi/flask/django) must already be in your environment.

Quick start — FastAPI

from fastapi import FastAPI
from wacp.fastapi import wacp_router

app = FastAPI()

app.include_router(
    wacp_router(
        app,
        base_dir="ai",
        discover=True,
    )
)

Quick start — Flask

from flask import Flask
from wacp.flask import wacp_router

app = Flask(__name__)

app.register_blueprint(
    wacp_router(
        app,
        base_dir="ai",
        discover=True,
    )
)

Quick start — Django

# urls.py
from wacp.django import wacp_router

urlpatterns = [
    # ... your routes ...
] + wacp_router(base_dir="ai", discover=True, urlconf="myproject.urls")

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

Package layout

wacp/
  core/          # config, scaffold, search, types (shared across all frameworks)
  fastapi/       # FastAPI adapter (wacp_router, FastAPIDiscovery)
  flask/         # Flask adapter (wacp_router, FlaskDiscovery)
  django/        # Django adapter (wacp_router, DjangoDiscovery)

Routes

Discovery

Each adapter supports discover=True which scans your app's routes and writes config/_discovered.json:

• FastAPI: wacp_router(app, discover=True)
• Flask: wacp_router(app, discover=True)
• Django: wacp_router(discover=True, urlconf="myproject.urls")

The file is never served and never merged — copy blocks into your endpoints.json.

Search & pagination

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

License

MIT