Skip to content

hsu3046/mindbusiness

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 MindBusiness AI

Tagline-en

"I asked ChatGPT, but I still ended up doing all the thinking myself." If you have a business idea but don't know where to start, just have 3 conversations with AI. We'll turn your scattered thoughts into a clear, structured strategy — tailored to your situation.

Tagline-ko

"챗GPT한테 물어봤는데 결국 내가 다 정리해야 했어요." 사업 아이디어는 있는데 정리가 안 된다면, AI와 3번만 대화하세요. 내 상황에 맞는 방식으로 아이디어를 한눈에 정리해드립니다.

Tagline-ja

「ChatGPTに聞いてみたけど、結局自分で全部まとめることになった。」 ビジネスアイデアはあるのに、整理できずにいるなら、AIと3回話すだけで大丈夫です。 あなたの状況に合わせて、アイデアをわかりやすく整理します。


Summary-en

You have a business idea — but no idea where to begin? MindBusiness AI is more than just a mind mapping tool. Start with a conversation. In just 3 exchanges, the AI understands your situation and organizes your ideas in the way that makes the most sense right now. When you get stuck, you're not on your own. The AI reads the context and suggests your next idea, right when you need it. Once everything comes together, the AI compiles it all into a draft business plan. The idea that lived only in your head — finally becomes a document.

Summary-ko

사업 아이디어는 있는데, 어디서부터 정리해야 할지 막막하신가요? MindBusiness AI는 단순한 마인드맵 도구가 아닙니다. 처음엔 그냥 대화하세요. 3번의 질문만으로 AI가 상황을 파악하고, 지금 가장 필요한 방식으로 아이디어를 구조화합니다. 막히는 순간도 혼자가 아닙니다. AI가 맥락을 읽고, 다음 아이디어를 바로 제안합니다. 아이디어가 정리되면, AI가 모든 내용을 모아 사업계획서 초안으로 만들어드립니다. 머릿속에 있던 아이디어가, 처음으로 문서가 되는 순간입니다.

Summary-ja

ビジネスのアイデアはあるのに、どこから手をつければいいかわからない。そんな経験はありませんか? MindBusiness AI は、単なるマインドマップツールではありません。 まずは、気軽に話しかけてみてください。3回の会話だけで、AIがあなたの状況を把握し、今一番必要な形でアイデアを整理していきます。 行き詰まっても、一人で悩まなくて大丈夫です。AIが文脈を読み取り、次のアイデアをすぐに提案してくれます。 アイデアがまとまったら、AIがすべての内容をまとめて事業計画書の初稿を作成します。頭の中にあったアイデアが、はじめて「形」になる瞬間です。


✨ What It Does

  • Understands your intent through conversation — A smart 3-turn dialogue figures out exactly what kind of analysis you need before generating anything.
  • Picks the right framework automatically — AI selects the best fit from 9 business frameworks (BMC, Lean Canvas, SWOT, PESTEL, and more) based on your context.
  • Generates structured mindmaps instantly — Get a fully interactive, hierarchical map built on the selected framework in seconds.
  • Expands nodes infinitely with context-aware AI — Click any node and the Hybrid Expansion Engine drills deeper using Logic Trees or nested frameworks, depending on what makes sense.
  • Streams professional business reports — Generate polished reports from your mindmap via real-time SSE streaming.
  • Speaks your language — Full trilingual support in Korean, English, and Japanese.
  • Keeps your keys safe — BYOK (Bring Your Own Key) model means your Gemini API key never touches our servers.

🛠 Tech Stack

Layer Technology
Frontend Next.js 16 (App Router), React 19, TypeScript 5
Styling Tailwind CSS 4
UI Components shadcn/ui, Lucide Icons, HugeIcons
Visualization React Flow (XYFlow), D3 Hierarchy, Dagre
Animation Framer Motion
State Zustand 5
Backend FastAPI, Python 3.9+, Pydantic v2
AI Google Gemini (gemini-2.5-flash, gemini-2.5-pro)
Rate Limiting SlowAPI

📦 Installation

git clone https://github.com/hsu3046/MindBusiness.git
cd MindBusiness

Backend

cd backend
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env      # Fill in your GEMINI_API_KEY
python main.py

Frontend

cd frontend
npm install
npm run dev

Open http://localhost:3000 → Click ⚙️ → Enter your Gemini API key.


📁 Project Structure

MindBusiness/
├── backend/                    # FastAPI + Gemini AI Engine
│   ├── logic/                  # Core AI logic modules
│   │   ├── classifier.py       # Intent classification & 3-turn conversation
│   │   ├── generator.py        # Mindmap skeleton generation (SoT)
│   │   ├── expander.py         # Infinite node expansion (Hybrid Engine)
│   │   └── report_generator.py # AI report generation (SSE streaming)
│   ├── prompts/                # System prompts & framework templates
│   ├── schemas/                # Pydantic request/response models
│   ├── lib/                    # Shared utilities
│   ├── tests/                  # Backend tests
│   ├── config.py               # Model & environment configuration
│   └── main.py                 # FastAPI application entry
├── frontend/                   # Next.js + TypeScript
│   ├── app/                    # App Router pages
│   ├── components/             # UI components (mindmap, settings, etc.)
│   ├── lib/                    # API client, utilities
│   ├── stores/                 # Zustand state management
│   ├── hooks/                  # Custom React hooks
│   └── types/                  # TypeScript type definitions
├── docs/                       # Project documentation
├── LICENSE                     # GNU GPL v3
└── README.md

� Supported Frameworks

ID Name Best For
BMC Business Model Canvas Established business planning
LEAN Lean Canvas Startup ideas, problem-solving
SWOT SWOT Analysis Competitive strengths & weaknesses
PESTEL PESTEL Analysis Macro-environmental factors
PERSONA User Persona Deep customer understanding
PROCESS Step-by-Step Process Roadmaps, workflows
WHYS 5 Whys Root cause analysis
SCAMPER SCAMPER Creative problem-solving
LOGIC 5W1H Structured logical analysis

🔑 API Key Management (BYOK)

MindBusiness uses a Bring Your Own Key model:

  1. Browser UI: Click ⚙️ icon → enter your key → stored in localStorage only
  2. Server fallback: Set GEMINI_API_KEY in backend/.env for shared deployments
  3. Priority: User key (header) > Server key (.env)

Your API key is never stored on the server — it travels only as an X-API-Key HTTP header per request.


� Roadmap

  • GoT (Graph-of-Thoughts) insight discovery across branches
  • PNG/PDF mindmap export
  • Share links with expiration
  • Database persistence (PostgreSQL)
  • User authentication & saved sessions
  • Prompt caching for cost optimization

🤝 Contributing

Contributions are welcome! Please follow these steps:

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

📄 License

This project is licensed under the GNU General Public License v3.0.


Built by KnowAI · © 2026 KnowAI

About

AI strategic thinking tool that turns any business idea into a structured mindmap. 3-turn conversation → auto-selects the best framework (BMC, SWOT, Lean Canvas + 6 more) → infinite node expansion. Built with Next.js + FastAPI. BYOK model.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors