Files
hope-voice-api/tests
snowspeeder ce8fd1e046
Rebuild & Deploy / rebuild (push) Successful in 1m0s
fix: move media server to 8093 — YOURLS/Apache owns 8092 on xNAS
The Unraid deployment's /media/api requests were answered by an
Apache/YOURLS stack squatting on 8092, surfacing as UI 503s; the CI
healthcheck (curl without -f) counted that 503 as healthy, so run #15
deployed green against a broken media server.

- media server port 8092 -> 8093 everywhere (server, MCP, agent, nginx,
  compose, CI, .env.example, docs, tests).
- healthchecks use curl -f in compose and rebuild.yml so HTTP error
  statuses fail deployment.
- tests default to the Unraid deployment (VOICE_WEB_URL=
  https://192.168.86.2:9178); token goes through nginx (loopback :8091
  is unreachable off-host); bind-mount-coupled tests skip on remote
  targets. AGENTS.md documents the convention and both failure modes.
2026-08-29 16:01:26 -04:00
..

Hope test suite

End-to-end tests that drive the actual running container — no mocks. They run on the host and hit the live web UI, token endpoint, LLM API, MCP tool servers, and agent process.

Prerequisites

  • The container is up: docker compose up -d (and healthy)
  • Host deps installed: pip install -r tests/requirements.txt (or uv pip install -r tests/requirements.txt)
  • The LLM at LLM_BASE_URL (default http://192.168.86.2:3005/api, OpenWebUI) is reachable
  • Internet access for the weather tool tests (wttr.in)

Run

cd /home/shane/dev/voice
python -m pytest tests/ -v            # everything
python -m pytest tests/ -v -m "not slow"   # skip LLM/network-heavy tests

What each file covers

File Target Notes
test_web_ui.py nginx HTTPS UI (:9178) + token endpoint (:8091) static assets, /token (direct + via nginx), /livekit/ proxy
test_llm_api.py LLM API directly completion, tool calling, enable_thinking=false latency, streaming
test_mcp_tools.py MCP servers via docker exec weather/time, authenticated remote memory save/recall/delete, and local skills — probes are cleaned up
test_media.py media server API + player UI + media MCP library/player state flow, Range proxy, static mp3 Range, live YT Music search (-m slow), gated full download (HOPE_RUN_YTDLP_DOWNLOAD=1)
test_agent_integration.py running container agent process alive, worker registered with LiveKit, all 4 supervised processes up, container health, LiveKit HTTP API
test_compaction.py HopeLLM._compact_context in-container compaction triggers >24 items, system prompt preserved, short context untouched

Notes

  • LLM and MCP tests are marked @pytest.mark.slow (1–30s each).
  • The token endpoint is POST /token → {"token": "<JWT>"}.
  • Process checks use /proc/*/cmdline because the container image has no ps, and the supervisorctl unix socket is not exposed in this build.