This project exposes eyecite's core citation extraction, resolution, annotation, and cleaning functions as a RESTful API using FastAPI.

• POST /extract — Extract citations from text
• POST /resolve — Cluster and resolve citations
• POST /annotate — Annotate text with citation markup
• POST /clean — Clean and preprocess text
• POST /extract-resolve — Extract and resolve citations in one step
• POST /dump — (Optional) Dump detailed citation metadata

All endpoints accept and return JSON.

# Build and run with Docker
cd /workspaces/eyecite

docker build -t eyecite-api .
docker run -p 8000:8000 eyecite-api

curl -X POST "http://localhost:8000/extract" \
  -H "Content-Type: application/json" \
  -d '{"text": "See 410 U.S. 113 (1973)."}'

Once running, visit http://localhost:8000/docs for interactive OpenAPI docs.

• Edit api/main.py to modify or add endpoints.
• Update requirements.txt for dependencies.
• See PLAN.md for design notes.

• Limit request size and sanitize input for production.
• Add authentication if needed.

See PLAN.md for more details and roadmap.