Visual Mind is a tool that helps you create interactive mind maps from a topic you enter, using artificial intelligence.
- AI-Powered: Automatically generates a mind map for the specified topic.
- Interactive Interface: Allows dragging nodes and zooming/panning the generated mind map (using
reactflow). - Dark Mode: Features a sleek, eye-friendly dark theme interface.
- Custom Nodes: Nodes display the topic title and AI-generated descriptions (if available). Descriptions appear next to the nodes.
- Frontend:
- Next.js (React Framework)
- React
- React Flow (For mind map visualization)
- TypeScript
- Backend (API):
- Next.js API Routes
- @google/genai (For communicating with the Google Gemini API)
- Styling:
- Inline Styles & Global CSS (JSX)
Follow these steps to run the project locally on your machine:
-
Clone the Repository:
git clone https://github.com/hasirciogli/visualmind.git cd visualmind -
Install Dependencies:
npm install # or # yarn install
-
Environment Variables: Create a file named
.env.localin the project's root directory. You'll need to add your Google Gemini API key to this file (required for the backend API to work):GOOGLE_API_KEY=YOUR_GOOGLE_API_KEY
You can obtain an API key from Google AI Studio.
-
Start the Development Server:
npm run dev # or # yarn dev
-
Open http://localhost:3000 in your browser.
- When you open the application, enter the topic you want to create a mind map for in the input field (e.g., "Artificial Intelligence", "Quantum Physics").
- Click the "Generate" button.
- The AI will generate a mind map related to your topic and display it on the screen.
- You can drag the nodes on the map and zoom in/out using the mouse wheel. Additional information boxes will appear next to nodes that include descriptions.
Contributions help make the project better. To report a bug or suggest a new feature, please open an "Issue" or submit a "Pull Request".
This project is licensed under the MIT License. See the LICENSE file in the project's GitHub repository for details.


