An intelligent engine to distill signal from noise. Transform sprawling topics into structured, actionable knowledge.
Explore the Live Demo »
Report Bug
We live in an era of unprecedented access to information, yet understanding remains elusive. The modern challenge isn't finding data—it's structuring it. Synapse was born from this challenge. It acts as an intelligent companion for the crucial first step of any knowledge-intensive endeavor: building a solid conceptual framework.
Whether you're a student tackling a new domain, a researcher mapping a field, or a creator planning content, Synapse automates the grueling process of creating a high-level overview. It transforms a single line of intent into a comprehensive, hierarchical blueprint, freeing you to focus on what truly matters: insight and creation.
When done with blueprinting, generate a detailed, well-cited document that serves as a foundation for your project, whether it's an article, book, course, or any other knowledge product.
- 🧠 Intelligent Scaffolding: Leverages Google's Gemini with a sophisticated meta-prompt to generate a clean, structured conceptual map from a single user prompt.
- 🌐 Dynamic Visualization & Editing: Renders blueprints as interactive graphs using React Flow. Users can refine the structure with an intuitive command palette (
⌘+K) for adding, renaming, deleting, and reorganizing nodes. - 📚 Automated Research & Synthesis: For each terminal node in the blueprint, Synapse performs targeted web searches via the Serper API, scrapes high-quality sources, and uses an AI synthesizer to generate concise paragraphs with embedded Markdown citations.
- 📄 Professional Export Options: Exports the visual blueprint or the final, detailed content document as a professionally formatted PDF using Puppeteer, ready for printing or sharing.
- 🔄 Iterative Development: The entire process is designed for refinement. Start broad, then drill down, expand concepts, and prune irrelevant branches until the blueprint perfectly matches your vision.
Synapse is built with a modern, full-stack TypeScript architecture, leveraging a serverless backend via Next.js API Routes for maximum scalability and ease of development.
| Category | Technology | Description |
|---|---|---|
| Frontend | Next.js (React), TypeScript | Core application framework and language for type-safety. |
| UI / UX | React Flow, Tailwind CSS, shadcn/ui | Interactive graph visualization, utility-first styling, and UI components. |
| Backend | Next.js API Routes | Serverless functions for all backend logic. |
| AI & Services | Google Gemini, Serper API | AI model for generation/synthesis and low-latency web search. |
| Data Handling | @extractus/article-extractor, md-2-pdf | Web scraping for content synthesis and server-side PDF generation. |
Synapse is an actively developed project. The future vision is to evolve from a user-directed tool into a proactive, agentic knowledge partner.
The next-generation of Synapse will feature an AI agent that can:
-
Autonomously Evolve Blueprints Given a high-level goal, the agent will proactively research, propose new nodes, identify missing concepts, and restructure the blueprint for optimal clarity.
-
Self-Correction and Validation The agent will be able to critique its own output, cross-reference sources, and refine the blueprint based on logical consistency and coverage of the topic.
-
Goal-Oriented Research Instead of just processing leaf nodes, the agent will understand the user's end goal (e.g., "write a book," "plan a course") and tailor the research and synthesis process accordingly.
Expanding how users interact with and manage their blueprints:
-
PDF Import Seamlessly ingest research papers, notes, and other documents into Synapse, auto-generating blueprint nodes from content structure.
-
History & Version Snapshots Automatically save historical versions of each blueprint, allowing users to rewind, compare, and branch off at any stage.
-
Auto-Save & Cloud Sync Ensure every interaction is persistently stored and available across devices.
Move beyond PDF to a suite of standard formats to ensure Synapse fits into any workflow:
-
Markdown (
.md) For easy integration with Obsidian, Logseq, and other text-based tools. -
Microsoft Word (
.docx) For traditional document editing and collaboration. -
JSON / XML Export the raw blueprint structure for use in other applications or custom workflows.
-
PowerPoint (
.pptx) Automatically generate a presentation skeleton from the blueprint structure.
Deepen the connection with the tools our users love:
-
Native Notion & Obsidian Integration Two-way sync to push and pull blueprint updates directly from your knowledge base.
-
Git-Based Versioning Save blueprints to a GitHub repository for version control, branching, and collaboration.
-
Real-Time Collaboration Allow multiple users to view and edit a blueprint simultaneously, with changes reflected live.
Follow these instructions to set up a local development environment.
- Node.js: v18.x or newer
- npm, yarn, or pnpm package manager
- Google AI API Key: Get one from Google AI Studio
- Serper API Key: Get one from Serper.dev
-
Clone the repository:
git clone https://github.com/PearlGrell/synapse.git cd synapse -
Install dependencies:
npm install
-
Set up environment variables: Create a
.env.localfile in the project root and add your API keys:# .env.local # Get from Google AI Studio: https://makersuite.google.com/ GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY" # Get from Serper.dev: https://serper.dev/ SERPER_KEY="YOUR_SERPER_API_KEY"
-
Run the development server:
npm run dev
Open http://localhost:3000 in your browser to see the application.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
To contribute:
- Fork the Project: Click the 'Fork' button at the top right of this page.
- Create your Feature Branch:
git checkout -b feature/AmazingFeature
- Commit your Changes:
git commit -m 'Add some AmazingFeature' - Push to the Branch:
git push origin feature/AmazingFeature
- Open a Pull Request: Go to the 'Pull Requests' tab of your forked repository and open a new PR.
Please ensure your PRs are descriptive and link to any relevant issues.
Distributed under the MIT License. See LICENSE.md for more information.
Pearl Grell - aryantrivedi.lko@gmail.com
Project Link: https://github.com/PearlGrell/synapse