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. Planner / retrieval / critic / synthesizer run a simulated cycle (no Gemini or Tavily quota). Switch to Live only if GEMINI_API_KEY and TAVILY_API_KEY are set on the host. 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 mode never calls Gemini or Tavily. 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