Skip to content

Repository files navigation

Veritas Engine

Self-correcting multi-agent research console. Plan queries, retrieve in parallel, grade the evidence, loop until the critic passes, then synthesize a Markdown brief.

Live Demo CI Next.js LangGraph TypeScript License


Live Demo

https://veritas-engine-woad.vercel.app/

Status: The public site defaults to Demo mode (simulated). Keys alone do not enable spend — set LIVE_MODE=true (optional PUBLIC_RUN_TOKEN / x-run-token). There is no login.

This is the only public repo for the project.


Screenshots

Veritas Engine

Console Cycle
Dark orchestration panel and graph Live logstream and graph during a demo run
Brief Quality audit
Synthesized Markdown brief Critic score ring and auditor notes

Features

  • LangGraph.js cycle: Planner → Retrieval → Critic → (loop or) Synthesizer
  • Critic scores 1–10 and reroutes below 8 until max iteration depth
  • Parallel Tavily searches on Live; mock hits on Demo
  • SSE stream of node updates into the logstream and graph visualizer
  • Custom zero-dependency Markdown renderer (headings, tables, lists, code)
  • Copy brief or export .md
  • Dark / light console; Demo / Live toggle

Tech Stack

Layer Technology
Frontend Next.js 14 App Router, React 18, TypeScript, Tailwind 3
Agents LangGraph.js + LangChain.js (Annotation.Root)
LLM (Live) Gemini 2.5 Flash via @langchain/google-genai
Search (Live) Tavily Search API
Streaming Server-Sent Events from POST /api/research
Data on Vercel Demo repository (simulated retrieval + canned brief)
Auth None
Hosting Vercel
CI GitHub Actions — Vitest, tsc, Playwright

Architecture

Start → Planner → Retrieval (parallel) → Critic
                      ↑                    │
                      └── score < 8 ───────┤
                                           ▼
                                    Synthesizer → Markdown UI

Quick Start

git clone https://github.com/devtechedge/veritas-engine.git
cd veritas-engine
npm install
cp .env.example .env.local
npm run dev

Open http://localhost:3000. Demo mode runs without keys.

npm test
npm run typecheck
npx playwright install chromium
npm run test:e2e

Security

Portfolio demo: no login. Demo is forced unless LIVE_MODE=true (and optional run token). Headers, origin checks, rate limits: see SECURITY.md. Live keys stay on the server.

Details: SECURITY.md.


License

MIT. See LICENSE.

About

Self-correcting multi-agent research engine for technical briefs. Planner drafts queries, Tavily retrieves in parallel, a critic grades 1-10 and loops until >=8 or max depth, then a synthesizer writes Markdown. Next.js 14, LangGraph.js, Gemini 2.5 Flash, SSE. Public Vercel is Demo mode (simulated). Live needs GEMINI_API_KEY and TAVILY_API_KEY. MIT.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages