Welcome
Turn your documents into a searchable workspace where AI agents find evidence, write reports, and verify every claim against your original files.
Spinosa turns a folder of research documents into a local workspace you can chat with. Ask questions in plain language. Spinosa searches your files, drafts an answer, and checks every claim against the original text. No cloud, no uploads, your documents stay on your machine.
Quick start
# Install (macOS, Linux)
curl -fsSL https://github.com/medialab/spinosa/releases/download/stable/install.sh | bash
# Launch the dashboard
spinosa
The first time you run spinosa, you'll see the workspace picker. Click + New workspace and follow the 11-step wizard: pick your document folder, name the workspace, review what was found, and choose your preferred AI coding tool.
When the wizard finishes, you'll see a chat prompt. Ask your first question.
What you get
- A chat interface connected to your documents
- A workspace on disk with your converted files, configuration, and reports
- Reports with evidence quotes, source paths, and a verification status
- A visualizer to explore how your AI agent worked through your question
