Skip to content

About

Local research workspace with traceable citations, reviewed claims, optional Ollama AI, and portable backups.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

SourcePilot — Open Research Engine

Research any topic. Every claim has a source.

Release 1.0.0 · CI

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.

Italiano

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

Avvio rapido (Windows)

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.ps1

Apri 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.

Funzioni 1.0

  • 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.

English

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

Quick start (Windows)

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.ps1

Open 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.

Version 1.0 features

  • 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.

Licenza e contributi / License and contributions

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.

Sostieni il progetto / Support development

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.

Sviluppo / Development

python -m pip install -c requirements.lock -e ".[test]"
python -m pytest -q
node --check sourcepilot/static/app.js

Piano implementazione 1.0 / Implementation plan

About

Local research workspace with traceable citations, reviewed claims, optional Ollama AI, and portable backups.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages