Turn your messy thoughts into organized clarity.

BrainDump is an AI-powered thought organizer that helps you make sense of mental clutter. Just dump all your thoughts—work stress, goals, random ideas—and let AI analyze, categorize, and provide actionable insights.

• AI Thought Analysis - Automatically identifies themes and patterns in your thoughts
• Mood Detection - Understands your emotional state from your writing
• Action Items Extraction - Finds tasks and goals buried in your mental clutter
• Smart Recommendations - Get personalized next steps based on your thoughts
• Interactive AI Chat - Ask follow-up questions about any recommendation

• History Management - Save and revisit past analyses
• Version Control - Edit and re-analyze thoughts, keeping track of changes
• Export Functionality - Download your analyses for reference
• Theme Categorization - Automatic grouping by work, health, relationships, goals, etc.

• Content Moderation - Filters harmful content while supporting mental health discussions
• Local Storage - Your data stays in your browser
• No Account Required - Start using immediately

Frontend:

• Vanilla JavaScript (ES6+)
• CSS3 with animations and glassmorphism effects
• Responsive design (mobile-friendly)

Backend:

• Node.js + Express.js
• GitHub Models API (GPT-4o-mini) - FREE!
• node-fetch for API calls

Storage:

• LocalStorage for browser-based persistence
• No database required

• Node.js (v14 or higher)
• GitHub Token with Models API access
• Modern web browser (Chrome, Firefox, Safari, Edge)

1. Clone the repository:

   git clone https://github.com/yourusername/braindump.git
   cd braindump

2. Install dependencies:

   npm install

3. Set up environment variables:

   Create a .env file in the root directory:

   GITHUB_TOKEN=your_github_token_here
   PORT=3000

4. Get your GitHub Token:

   • Go to GitHub Settings > Tokens
   • Create a new token with models:read scope
   • Copy the token to your .env file

5. Start the server:

   node server.js

   Or use nodemon for auto-restart:

   npm install -g nodemon
   nodemon server.js

6. Open in browser:

   http://localhost:3000
   

1. Enter your name when prompted (first-time setup)

2. Dump your thoughts in the text area:

   I need to finish the project presentation by Friday but I'm 
   feeling overwhelmed. Also need to start exercising more - 
   maybe join that gym? Haven't talked to Mom in a while...
   

3. Click "Analyze My Thoughts" and wait for AI analysis

4. Explore your results:

   • View identified themes
   • Check your mood indicator
   • See extracted action items
   • Read personalized insights
   • Get recommendations

5. Chat with AI by clicking any recommendation card

6. Manage history:

   • Click "View History" to see past analyses
   • Edit and re-analyze previous thoughts
   • Export or delete entries

braindump/
├── assets/
│   ├── images/          # Logo and UI icons
│   ├── app.js           # Frontend JavaScript
│   ├── style.css        # Styling and animations
│   ├── greetings.txt    # Random greeting messages
│   └── examples.txt     # Example thought dumps
├── index.html           # Main HTML file
├── server.js            # Express backend + API routes
├── package.json         # Dependencies
├── .env                 # Environment variables (create this)
└── README.md           # This file

Analyzes user thoughts and returns structured insights.

Request:

{
  "text": "Your thoughts here..."
}

Response:

{
  "themes": [...],
  "mood": "...",
  "actionItems": [...],
  "insights": "...",
  "recommendations": [...]
}

Interactive chat about recommendations.

Request:

{
  "message": "User question",
  "context": {...},
  "history": [...]
}

Response:

{
  "response": "AI response"
}

Automatically categorizes thoughts into themes like:

• 💼 Work & Career
• 🏥 Health & Wellness
• ❤️ Relationships
• 🎯 Goals & Dreams
• 💰 Finance
• 📚 Learning
• 🎨 Creative Pursuits

Get actionable advice based on your thoughts:

• Wellbeing suggestions
• Productivity tips
• Personal growth ideas
• Relationship guidance
• Health recommendations

Edit previous thought dumps and track changes:

• Original thought preserved
• Multiple versions stored
• Easy comparison
• No data loss

Edit assets/greetings.txt:

Welcome back, {name}! Ready to organize your thoughts?
Hey {name}! What's on your mind today?

Edit assets/examples.txt (separate with ---):

Your first example thought...
---
Your second example thought...

Edit themeIcons object in assets/app.js:

const themeIcons = {
  'work': '💼',
  'health': '🏥',
};

Contributions are welcome! Here's how:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Check if port 3000 is available
• Verify .env file exists with valid GITHUB_TOKEN
• Run npm install to ensure dependencies are installed

• Verify GitHub token has models:read scope
• Check console for API errors
• Ensure you're not exceeding rate limits

• Restart the server (Ctrl+C then node server.js)
• Clear browser cache and reload
• Check browser console for JavaScript errors

• Check browser's LocalStorage permissions
• Try a different browser
• Ensure JavaScript is enabled

• GitHub Models for free AI API access
• GPT-4o-mini for powerful language understanding
• Inspired by the need for better mental organization tools

Have questions or suggestions? Open an issue on GitHub!

GITHUB: @Gullutio MAIL: [email protected]