Research any topic. Every claim has a source.
Manutenzione / Maintenance — 2026-11-02: i sorgenti correnti richiedono pypdf 6.21.4 per due correzioni di sicurezza upstream. Per una nuova installazione usa la clonazione sotto; gli artefatti 1.0.0 precedenti non sono stati sostituiti. / Current source requires patched pypdf 6.21.4. Use the clone instructions below for a new installation; older 1.0.0 artifacts have not been replaced. Dettagli / Details.
SourcePilot 1.0.0 è un'applicazione di ricerca locale per un solo utente. Conserva fonti originali, trova passaggi e costruisce affermazioni con citazioni verificabili. Web app, API e CLI condividono il workspace SQLite; la persona decide quali affermazioni approvare.
Prova senza AI con un file fittizio · Presentazione e richiesta feedback
Serve Python 3.11–3.14. In PowerShell, scarica prima il sorgente oppure esegui:
git clone https://github.com/MRJonam91/OpenResearchEngine.git
cd OpenResearchEngine
.\run.ps1Apri http://127.0.0.1:8765. Il primo avvio crea .venv e installa le dipendenze. Il workspace predefinito è ./workspace; per sceglierne uno diverso: .\run.ps1 -Workspace 'D:\Research\MioWorkspace' -Port 8765. Ferma il server con Ctrl+C.
Su Linux/macOS: crea e attiva un ambiente virtuale Python, esegui python -m pip install -c requirements.lock -e ., poi sourcepilot serve --workspace ./workspace. Windows e Linux sono verificati in CI con Python 3.11 e 3.14; macOS usa lo stesso percorso ma non è incluso nella matrice CI.
- Importa TXT, Markdown, HTML, DOCX, PDF con testo selezionabile, CSV e TSV (massimo 20 MB per file), file o cartelle scelti nel browser, oppure URL pubblici HTTP/HTTPS.
- Conserva originali e versioni; mostra i passaggi con posizione, data di importazione e hash SHA-256. La ricerca testuale SQLite FTS5 usa la versione più recente, con opzione esplicita per cercare nella cronologia.
- Permette di creare, correggere e revisionare affermazioni, collegare prove che supportano/contrastano/contestualizzano, e confrontare due fonti affiancate.
- Supporta la cancellazione controllata di fonti e affermazioni via UI, API e CLI con blocco di sicurezza se una fonte è usata in un'affermazione.
- Esporta report Markdown, PDF e JSON con citazioni a livello di passaggio. Solo affermazioni approvate o incerte entrano nel report predefinito.
- Espone API locali e CLI per automazioni personali, con comandi per ispezionare ed eliminare fonti e affermazioni filtrate per stato.
- Aggiunge ricerca semantica, proposte di affermazioni e candidati disaccordi con Ollama locale opzionale; ogni citazione proposta deve corrispondere a un passaggio e a una citazione testuale esatta.
- Controlla l'integrità e crea backup ZIP portabili con checksum e ripristino in una nuova cartella.
Il flusso manuale funziona senza Ollama. Per l'AI, avvia il runtime e scegli modelli già installati: .\run.ps1 -Model 'qwen2.5-coder:7b' -EmbeddingModel 'all-minilm:latest'. Non vengono scaricati modelli automaticamente. La copertura analizzata è visibile; una proposta accettata diventa una bozza da revisionare. Una citazione indica la provenienza del testo, non la sua verità.
OCR, ricerca autonoma sul web e hosting multiutente sono oltre la 1.0. Il PDF segnala caratteri non rappresentabili dal font; Markdown conserva Unicode. Prima di aggiornare, ferma il server e copia l'intero workspace. Dati e report possono contenere documenti e percorsi locali in chiaro. Guida 1.0 · Architettura · Roadmap · Changelog.
SourcePilot 1.0.0 is a local research application for one user. It retains originals, finds locatable passages, and builds claims with inspectable citations. The web app, API, and CLI share a SQLite workspace; people make review decisions.
Try it without AI using a fictional source · Sharing and feedback
Install Python 3.11–3.14. In PowerShell, download the source first or run:
git clone https://github.com/MRJonam91/OpenResearchEngine.git
cd OpenResearchEngine
.\run.ps1Open http://127.0.0.1:8765. First run creates .venv and installs dependencies. Default workspace is ./workspace; to choose another: .\run.ps1 -Workspace 'D:\Research\MyWorkspace' -Port 8765. Stop with Ctrl+C.
On Linux/macOS, create and activate a Python virtual environment, run python -m pip install -c requirements.lock -e ., then sourcepilot serve --workspace ./workspace. CI checks Windows and Linux with Python 3.11 and 3.14; macOS follows the same installation path but is outside the CI matrix.
- Imports TXT, Markdown, HTML, DOCX, text-selectable PDF, CSV, and TSV (20 MB per item), browser-selected files/folders, or public HTTP/HTTPS URLs.
- Retains originals and source versions; displays passage locators, import times, and SHA-256 hashes. SQLite FTS5 text search uses the latest version by default, with an explicit history option.
- Creates, edits, and reviews claims; attaches supporting, challenging, or contextual evidence; compares two sources side by side.
- Provides controlled deletion for sources and claims via UI, API, and CLI, with referential protection if a source is referenced by claims.
- Exports passage-cited Markdown, PDF, and JSON reports. Only approved or uncertain claims appear by default.
- Provides a local API and CLI for personal automation, including commands to list, filter, and delete sources and claims.
- Adds optional local Ollama semantic search, cited claim proposals, and candidate disagreements. Each model citation must identify a supplied passage and an exact quote.
- Provides integrity diagnostics and portable checksummed ZIP backup/restore into a new directory.
The manual workflow works without Ollama. To enable AI, start your local runtime and configure already-installed models with --model and --embedding-model on sourcepilot serve, or use the PowerShell example above. Models are never downloaded automatically. Analysis coverage is shown, and accepted suggestions become proposed claims requiring review. A citation establishes provenance, not factual correctness.
OCR, autonomous web discovery, and shared hosting are beyond 1.0. Unsupported PDF glyphs produce an explicit error; Markdown preserves Unicode. Stop the server and copy the complete workspace before upgrading. Workspaces and exports may contain plaintext documents and local paths. 1.0 guide · Architecture · Roadmap · Changelog.
Codice originale / original code: GPL-3.0-or-later. NOTICE, dipendenze / dependencies, asset / assets. Nomi e marchi non sono concessi automaticamente dalla licenza software / names and trademarks are not automatically licensed.
Contribuire / Contribute · Sicurezza / Security · Assistenza / Support.
Puoi sostenere manutenzione e sviluppo tramite GitHub Sponsors, Ko-fi, Buy Me a Coffee o PayPal. Il supporto è volontario e non attribuisce licenze o diritti aggiuntivi.
Voluntary support through the links above helps maintenance and development and grants no additional licenses or project rights.
python -m pip install -c requirements.lock -e ".[test]"
python -m pytest -q
node --check sourcepilot/static/app.js