v3.0 — Research Agent now available

Your research,
turned into a living map.

Capture browsing in real time. Build a beautiful interactive D3 graph. Get proactive, high-leverage suggestions from the Grok Research Agent — all running locally on your machine.

Download & run locally → See how it works

Free & open source • macOS (source works everywhere) • Your data never leaves your computer

🤖

v3.0 Research Agent

Proactive suggestions + autonomous mode

📡

Live browser capture

Chrome extension → real-time nodes

🕸️

D3 forceSimulation

Professional cluster-aware physics

💾

Local SQLite + history

Durable, private, undo/redo

NEW IN V3.0

The Research Agent

A proactive co-pilot that analyzes your full graph + objective and suggests high-leverage next directions with concrete bridges back to your existing work.

Try it in the real app →

🤖 Research Agent suggestions

Demo (real version uses Grok)

Your graph (live)

Demo mode

18 nodes • 47 edges

Recently added via agent

In the real app these suggestions become real nodes + edges with full undo, history, and SQLite persistence.

Autonomous mode runs in the background and notifies you when fresh suggestions are ready (never auto-adds).

Everything you need for serious research work

📡

Real-time browser capture

Chrome extension + local HTTP server. New research pages appear as nodes and edges instantly while you browse. Also supports file-watcher mode.

🕸️

Professional D3 force graph

Native forceSimulation with cluster-aware physics, semantic & temporal edge categories, full bidirectional selection, search, physics controls, and zoom-independent label sizing.

🧠

Grok-powered intelligence

Node summaries, Connected Edges explanations (stronger reasoning model), Research Gaps, Next Steps, and the new proactive Research Agent. All results cached with change awareness.

🗄️

Durable local persistence (v2.8+)

Full SQLite + SQLAlchemy + Alembic. Lossless migration from old JSON projects. Remembers your last project. Every change is written through safely.

🔄

Autonomous + manual agent

Run the Research Agent on demand or let it check every 3–120 minutes in the background. You stay in full control — it only notifies.

🛡️

Local-first & private by design

Your graphs, notes, and AI results live only on your machine. You bring your own Grok API key. No accounts. No cloud sync required.

Get running in under a minute

Clone & launch

One command gives you the full modern experience with the Research Agent.

Load the extension (optional but magical)

The included Chrome extension sends real browsing activity straight into your graph while you work.

Research + use the Agent

Open AI Intelligence → Research Agent tab. Get suggestions. Add the ones you like. Let autonomous mode run in the background.

Easy download & run

The fastest way to experience the full v3.0 Research Agent + live capture is to run it locally. We’ve made both paths extremely robust.

RECOMMENDED FOR TRYING RIGHT NOW

Run from source (latest + easiest)

Zero packaging. The launcher includes syntax guards, automatic cleanup, and the full modern NiceGUI + D3 experience.

Terminal

git clone https://github.com/schrodingertuller/research-mapper.git
cd research-mapper
pip install -e ".[dev]"
python launch_nicegui.py

View full instructions on GitHub →

FOR A CLEANER APP-LIKE EXPERIENCE

Build the macOS .app

Creates a standalone Research Mapper.app that launches the UI in a dedicated Chrome window (no tabs or address bar). Includes the extension + testing instructions.

Terminal

pip install pyinstaller
python build_nicegui_app.py

The resulting dist/ folder is ready to zip and share. See TESTING-INSTRUCTIONS.txt inside.

Also available

GitHub Releases (v3.0) Full documentation & roadmap Chrome Extension source

Pre-built zips and signed .apps will be attached to future releases. Source + build script are currently the most reliable paths.

Your research, turned into a living map.