palimpseste-max / web /README.md
thefinalboss's picture
Upload web/README.md with huggingface_hub
bc7f6f9 verified
|
Raw
History Blame Contribute Delete
1.22 kB
# 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