DeepEye Backend

March 31, 2026 ยท View on GitHub

FastAPI and Celery backend for the DeepEye data agent system.

Responsibilities

  • authentication and session management
  • datasource, session, and workspace-state APIs
  • chat orchestration and workflow planning
  • workflow draft/run/artifact persistence
  • sandbox-backed execution for report, dashboard, and video nodes

Run the backend as part of the monorepo Docker stack:

docker compose up --build

The API is then available behind the gateway at http://localhost:8080/api/....

If you need to apply schema migrations manually outside Docker:

uv run alembic -c packages/backend/alembic.ini upgrade head

Tests

Default backend and core tests:

uv run pytest packages/backend/app/test packages/core/tests -q

Docker-backed sandbox integration tests are opt-in:

DEEPEYE_RUN_DOCKER_TESTS=1 uv run pytest \
  packages/backend/app/test/test_sandbox.py \
  packages/backend/app/test/test_sandbox_manager.py -q

Notes

  • Runtime schema changes now go through Alembic migrations. Docker Compose runs alembic upgrade head before the API and worker start.
  • Open-source hardening work is tracked in docs/open_source_remediation_checklist.md.