# PALIMPSESTE Web

Official React application for the PALIMPSESTE hypervectorial cortex.

## Quick Start

```bash
# 1. Start the API server (from project root)
pip install fastapi uvicorn
python examples/api_server.py --model thefinalboss/palimpseste-max --port 3332

# 2. Start the React dev server (in web/)
cd web
npm install
npm run dev

# 3. Open http://localhost:3333
```

## Production Build

```bash
cd web
npm run build    # outputs to web/dist/
```

The API server automatically serves the built React app from `web/dist/` when it exists.
No separate web server needed — FastAPI serves everything.

## Features

- **Real-time chat** with confidence scores, source labels, and explanation traces
- **Live metrics dashboard** — memory traces, capacity gauges, config, conversation state
- **Memory heatmap** — visualizes recent traces by weight
- **Teach panel** — instantly teach new facts via O(1) memory writes
- **Fact chain visualization** — see multi-hop reasoning steps inline
- **2026 aesthetic** — glassmorphism, animated gradients, dark theme

## Tech Stack

- React 19 + TypeScript
- Vite 6 (build tool)
- Tailwind CSS 3 (styling)
- No external UI libraries — everything custom-built