GitHunt
VI

vivganes/fact-check-copilot

โš–๏ธ Veritas - Fact Check Copilot

A rigorous AI fact-checking assistant powered by GitHub Copilot SDK.

Preview

Features

  • ๐Ÿ“ฐ Clean, professional journalism-inspired UI
  • โœ๏ธ Typography: Merriweather (serif) for content, Inter (sans) for UI
  • ๐Ÿ” Fact-checking with structured verdicts (True/False/Mixed/Unverified)
  • ๐Ÿ“Š Confidence indicators and evidence citations
  • ๐ŸŒ URL input support for fact-checking article content
  • ๐Ÿ’พ Persistent model selection via localStorage

Prerequisites

Quick Start

1. Start the Backend

cd backend

# Create virtual environment (first time only)
python -m venv venv

# Activate venv
.\venv\Scripts\activate    # Windows
source venv/bin/activate   # Linux/Mac

# Install dependencies
pip install -r requirements.txt

# Run server
uvicorn main:app --reload --port 8000

2. Start the Frontend

cd frontend

# Install dependencies (first time only)
npm install

# Run dev server
npm run dev

3. Open Veritas

Navigate to http://localhost:5173 โš–๏ธ

Testing

# Backend tests
cd backend
.\venv\Scripts\activate
pytest tests/ -v

# Frontend tests
cd frontend
npm test

# E2E tests
cd frontend
npx playwright install  # first time
npx playwright test

Project Structure

veritas/
โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ main.py              # FastAPI server
โ”‚   โ”œโ”€โ”€ copilot_service.py   # Copilot SDK wrapper
โ”‚   โ”œโ”€โ”€ mock_copilot.py      # Mock for testing
โ”‚   โ””โ”€โ”€ models.py            # Pydantic schemas
โ””โ”€โ”€ frontend/
    โ”œโ”€โ”€ src/
    โ”‚   โ”œโ”€โ”€ App.jsx          # Main app
    โ”‚   โ”œโ”€โ”€ index.css        # Professional styling
    โ”‚   โ””โ”€โ”€ components/      # React components
    โ””โ”€โ”€ e2e/                 # Playwright tests

Environment Variables

Variable Description Default
USE_MOCK_SDK Use mock instead of real SDK false

Set USE_MOCK_SDK=true for development without Copilot CLI.

License

MIT

vivganes/fact-check-copilot | GitHunt