kamera 1.0.0

Realtime webcam streaming and video processing with a FastAPI UI

Kamera

Kamera streams your webcam in real time and gives you a fast control panel for brightness, rotation, grayscale, mirroring, and filters.

Install

pip install kamera

Run

kamera

Then open http://127.0.0.1:4141.

What is new in v1.0.0

• Refactored backend architecture with explicit camera lifecycle management.
• New API-driven UI state sync and reset workflow.
• Improved stream resilience for temporary camera read failures.
• Improved filter behavior (edges now handles color input safely).
• Added automated tests and modern project metadata in pyproject.toml.
• Added uv workflow and lockfile for reproducible local development.

Breaking changes in v1.0.0

• Recommended Python version range is now >=3.10.
• JSON API endpoints are now primary:
  • GET /api/settings
  • POST /api/settings
  • POST /api/settings/reset
• Legacy POST /settings still works for form clients, but new integrations should migrate to /api/settings.

API

GET /video_feed

Returns an MJPEG stream from the active webcam.

GET /api/settings

Returns current settings:

{
  "rotate": 0,
  "brightness": 1.0,
  "grayscale": false,
  "mirror": false,
  "filter_name": "none"
}

POST /api/settings

Updates one or more settings.

Example:

curl -X POST http://127.0.0.1:4141/api/settings \
  -H "content-type: application/json" \
  -d '{"rotate":90,"brightness":1.3,"grayscale":true,"filter_name":"sepia"}'

POST /api/settings/reset

Resets all settings to defaults.

curl -X POST http://127.0.0.1:4141/api/settings/reset

Development with uv

uv sync --extra dev
uv run pytest
uv run kamera

Release checklist

uv sync --extra dev
uv run pytest
uv build
uv run python -m pip install --force-reinstall dist/*.whl
kamera

Publish to PyPI:

uv run twine check dist/*
uv run twine upload dist/*

License

MIT