Repository navigation
Releases
v2.0.0
Veridex v2.0.0 is the version submitted for CSCI 599 Assignment 2: a multi-agent research assistant with RAG, hybrid LLM routing and streaming traces. It runs in its own Google Cloud project; Assignment 1 (v1.0.1, veridex-staging) is unchanged.
Live deployment
| Item | Value |
|---|---|
| URL | https://veridex-v2-596419356898.us-west1.run.app |
| Cloud Run service / region | veridex-v2, us-west1 (GCP project veridex-v2) |
| Serving revision | veridex-v2-00007-w4f (100% of traffic) |
| Image | us-west1-docker.pkg.dev/veridex-v2/veridex/veridex:v2.0.0 |
| Image digest | sha256:eb050ee78f65895a47a067ec3c571646214459294a8a8f78804abf3d4abbb9e9 |
| Source commit | c7e3f0c (this tag) |
| Instances | 1–3 (one kept warm during grading, so there is no cold start) |
What's included
- LangGraph Supervisor routing each turn to three specialized agents (Research, Summary, Data), each with its own prompt and MCP tools; a failing agent is recorded and never crashes the graph
- Hybrid cost/capability router across OpenAI
gpt-6.1-soland Googlegemini-3.8-flash, with every decision (rule, reason, signals, Gemini thinking budget) shown in the UI and trace, and automatic fallback to the other provider - RAG over 42 CC BY / CC0 arXiv papers (1,855 chunks, Chroma,
text-embedding-3-small) with citations linked to source chunks - Tavily Remote MCP for live web results;
search_evidenceandlist_documentsshared between agents over MCP POST /api/chat/streamServer-Sent Events and a vanilla HTML/JS page with routing chips, an orchestration trace and citation chips- Multi-turn conversations stored in Firestore, surviving restarts and new revisions
Results
On 35 fixed questions: RAGAS faithfulness 0.90, answer relevancy 0.79, context precision 0.96, context recall 1.00; $0.024 per question on average. Warm requests show the routing decision after about 2 s and the first answer token after about 11 s. Details in docs/evaluation.md.
Notes
- The corpus PDFs and Chroma index are not attached; rebuild them with the commands in
docs/corpus_v3.md. Attribution is inCORPUS_LICENSE_NOTICE.md. - Credentials are never included in the source or this release.
- Setup, local run and deploy instructions are in
README.md; architecture indocs/architecture.md.
v1.0.1 — Assignment 1 final
Veridex v1.0.1 is the version submitted for CSCI 599 Assignment 1. Assignment 2 builds on Veridex as v2.x, deployed to a separate Google Cloud project and a separate URL. This release and its deployment stay frozen.
Live deployment (frozen)
| Item | Value |
|---|---|
| Public API | https://veridex-staging-200331083905.us-west1.run.app/chat |
| Cloud Run service / region | veridex-staging, us-west1 |
| Serving revision | veridex-staging-mcp-log-35bbef6 (100% of traffic) |
| Image digest | sha256:8657fdecc15737cc29abec5dfdd7f79052332f3065f03e78678044f80cd4a391 |
| Image source commit | 35bbef63f6b7b704ac8c5b34c080f433b40faffd (an ancestor of this tag; later commits change only docs and packaging) |
| Corpus v2 bundle SHA-256 | 7f1398ecc8958faa6b0bb24cb9061ab0ec33d8e87f9782d8d9e72938891ae1fb |
The service stays publicly available, unchanged, until Assignment 1 grading and regrading are complete.
What's included
- A single LangGraph agent that gets its tools from three student-authored MCP servers over stdio: Evidence (
search_evidence), Web Search (search_web) and Workspace (list_documents,read_document) - RAG over a licensed five-paper corpus (586 chunks, Chroma,
text-embedding-3-small) - FastAPI
POST /chatwith per-session memory, request limits and sanitized logs - Deployed on Cloud Run with Secret Manager and a dedicated runtime service account
See README.md at this tag for setup, the API contract and deployment details.
Notes
- The corpus PDFs and index are not attached. Two papers are CC BY-NC 4.0; see
CORPUS_LICENSE_NOTICE.md. - Credentials are never included in the source or this release.