Skip to content

safrano9999/NAPOLEON_HILLS_AI_MASTERMIND_CLASSES

Repository files navigation

πŸ’° Napoleon Hill's AI Mastermind 🏦

Napoleon Hill

Napoleon Hill (1883–1970) was one of the most influential authors on personal success. His masterpiece Think and Grow Rich (1937) remains one of the best-selling books of all time. In Chapter 10 β€” The Mastermind, he revealed the greatest secret to success: A group of brilliant minds with a shared goal creates an invisible "third mind" that is more powerful than any individual.

"Whatever the mind of man can conceive and believe, it can achieve." β€” Napoleon Hill

Hill's legacy is preserved by the Napoleon Hill Foundation.


Screenshot

πŸš€ Quick Start β€” 2-Minute Setup

# 1. Clone the repo
git clone <repo-url>
cd NAPOLEON_HILLS_AI_MASTERMIND_CLASSES

# 2. Run setup (creates venv and installs only what this env needs)
python3 setup.py

# 3. Enter your API key
nano .env   # or open .env in your editor

# 4. Start!
python3 supervisor_loop.py

Optional β€” Start the Web Editor:

python3 mastermind_web.py
# β†’ opens http://127.0.0.1:7700

If OPENAI_API_BASE is set, setup skips litellm and uses the OpenAI-compatible HTTP endpoint directly. No need to activate a venv β€” the scripts find it automatically.


πŸ’΅ What Does the Program Do?

Everything runs in Markdown files β€” no database, no complicated setup. Members, sessions, personas, conversations β€” all .md files that you can edit in your browser or editor.

πŸ›οΈ Three Types of Members

Folder Type Description
members_ai/ πŸ€– AI Personas Characters with their own personality. The loop calls the LLM.
members/ πŸ‘€ Humans You write directly into the session file. The loop waits for you.
members_agents/ 🦾 Agents Autonomous agents that act independently.

AI Persona Examples:

  • πŸš€ Elon Musk β€” First principles, moonshots, execution
  • πŸ’Ž John D. Rockefeller β€” Strategy, discipline, long-term thinking
  • 🏭 Henry Ford β€” Mass production, efficiency, work ethic
  • πŸ”“ GPT-OSS β€” Fun to run with an abliterated (uncensored) LLM for unfiltered, raw debate
  • ...and many more in members_ai/

πŸ“œ Starting Sessions

Create a file in sessions/:

# My Business Idea
members: elon_musk, john_rockefeller, your_name
thesis: How do I build a company that lasts 100 years?

speaker: elon_musk

That's it. The loop takes over.


βš™οΈ Configuration

.env β€” API Keys (private, not visible in the editor)

# Uncomment and enter one key:
# OPENAI_API_KEY=...
# GEMINI_API_KEY=...
# KILOCODE_API_KEY=sk-...

mastermind_config.md β€” Settings (editable in the Web Editor!)

default_model: gemini/gemini-flash-latest
response_sentences: 4-5
sleep_seconds: 0.5
editor_refresh_ms: 2000
Setting Description Examples
default_model Which LLM to use gemini/gemini-flash-latest, openai/gpt-5.4, ollama/gpt-oss:20b
response_sentences Response length 2-3, 4-5, 1, 5-7
sleep_seconds Pause between cycles 0.5, 1, 10
editor_refresh_ms Browser refresh rate 1000, 2000, 500

Live Editing: Changes are applied immediately, no restart needed!


πŸ–₯️ Web Editor

python3 mastermind_web.py
# β†’ http://127.0.0.1:7700

Web Editor

Features:

  • πŸ“ All sessions, members, and config in one place
  • πŸ”„ Auto-refresh β€” watch AI responses come in
  • πŸ“œ Smart scroll β€” stays at the bottom when you're at the bottom
  • βš™οΈ Edit config directly in the browser
  • πŸ’Ύ Save with Ctrl+S / Cmd+S

🎯 Your Experience as a Human

  1. Open the Web Editor or the session in your favorite Markdown editor
  2. Watch the AI members discuss
  3. When it's your turn β€” just write under speaker: your_name
  4. Save β€” the loop continues automatically

πŸ’Έ You don't type any code. You just write.


πŸ“ Project Structure

NAPOLEON_HILLS_AI_MASTERMIND_CLASSES/
β”œβ”€β”€ .env                    # πŸ”‘ API Keys (private)
β”œβ”€β”€ mastermind_config.md    # βš™οΈ Settings (editable)
β”œβ”€β”€ supervisor_loop.py      # πŸ”„ The main loop
β”œβ”€β”€ mastermind_web.py       # 🌐 Web Editor
β”œβ”€β”€ setup.py                # πŸ“¦ Installation
β”œβ”€β”€ rules.md                # πŸ“œ Global rules for everyone
β”œβ”€β”€ members_ai/             # πŸ€– AI Personas
β”‚   β”œβ”€β”€ elon_musk.md
β”‚   β”œβ”€β”€ john_rockefeller.md
β”‚   └── ...
β”œβ”€β”€ members/                # πŸ‘€ Humans
β”‚   └── your_name.md
β”œβ”€β”€ members_agents/         # 🦾 Agents
└── sessions/               # πŸ’¬ Conversations
    └── my_session.md

πŸ”§ Supported LLM Providers

Runs on litellm β€” all major providers and locally running abliterated LLMs:

Provider Model Format Example
Ollama ollama/... ollama/gpt-oss:20b
Google gemini/... gemini/gemini-flash-latest
xAI xai/... xai/grok-4-1-fast-non-reasoning
Kilocode kilocode/... kilocode/z-ai/glm-5
OpenAI openai/... openai/gpt-5.4

πŸ’‘ Tips

  • Faster rounds? β†’ sleep_seconds: 0.25
  • Longer responses? β†’ response_sentences: 6-8
  • Test a different model? β†’ Just change it in the config, it's applied live
  • Multiple sessions in parallel? β†’ Just create more files in sessions/
  • Different providers per persona? β†’ Add model: (e.g. openai/gpt-5.4) to the top line of the persona .md file

πŸ’° "It is literally true that you can succeed best and quickest by helping others to succeed." β€” Napoleon Hill

🏦 Built on Napoleon Hill's Mastermind Principle.

About

Talk in a fully rounded discussion with Carnegie, Ford & Rockefeller πŸŽ©πŸ’ΌπŸ’° in rounds like Napoleon Hill's Think & Grow Rich. 4-5 sentences each. only MD-Files, each Member a subagent, only MD files and cronloops

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors