Skip to main content
Ralph Ideate

Ralph Ideate: The Idea Machine

ralph-ideate is an autonomous AI agent loop that ideates, extends, researches, scrutinizes, and repeats. It is the ralph loop for brainstorming: business ideas, investment opportunities, prediction market bets, and more.

CI PyPI version License


Why Automate Ideation?

Most ideas start as hunches and die as forgotten notes. The gap between "that could work" and "here's why it does" is filled with research, critical evaluation, and iteration. Work that's tedious to do systematically by hand.

Ralph Ideate closes that gap. You define a domain to explore, and an AI loop takes over: generating candidates, researching evidence, scrutinizing viability, and deciding what survives. Each iteration builds on the last. You steer the direction; the loop does the legwork.

Installation

uv tool install ralph-ideate
ralph-ideate init

During init you choose a brainstorming variant:

Variant Focus
Startup Ideas Business ideas validated through pain point research
Investment Investment opportunities, prediction market bets (Polymarket/Kalshi), stocks, crypto; validated through data analysis

Getting Started

All commands are Claude Code slash commands. You create a brainstorming domain under ideate/, explore it with the loop, and refine the domain description as you learn more.

1. Create a brainstorming domain

/ralph-ideate.create B2B services that agentic AI can fully automate end-to-end

Or for investments:

/ralph-ideate.create Mispriced Polymarket bets on US politics and tech events

2. Explore ideas

/ralph-ideate.explore @ideate/<your_idea_folder>

3. Refine a domain description

/ralph-ideate.refine @ideate/<your_idea_folder>

How It Works

Each iteration reads the domain state fresh and decides which phase to execute:

  1. Ideate - Generate and capture new candidate ideas
  2. Research - Validate ideas with real-world evidence
  3. Scrutinize - Critically evaluate viability and differentiation
  4. Decide - Verify, revise, or discard each candidate

Features

  • Systematic exploration: Covers ground broadly rather than pursuing singular solutions
  • Interactive steering: Inject thoughts and feedback during active processing to redirect focus
  • Evidence-based validation: Ideas must survive research with real data, not assumptions
  • Multi-pass refinement: Each iteration deepens understanding rather than forcing premature convergence

Acknowledgments

Inspired by Ralph Loop and Spec Kit. Read more about the motivation in the idea machine blog post.

Documentation

For full documentation, troubleshooting, and advanced usage, visit the GitHub repository.

Release files for ralph-ideate 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ralph-ideate 0.2.0
File Size Uploaded
ralph_ideate-0.2.0.tar.gz 141.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ralph-ideate 0.2.0
File Interpreter ABI Platform
ralph_ideate-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 187.0 kB

Release files / ralph_ideate-0.2.0.tar.gz

Download URL ralph_ideate-0.2.0.tar.gz
Size 141.6 kB
Tags Source
SHA-256 checksum
How to use checksums
97783549914c128b300dd42a4b34a209dc83a0548d37edbdc27cb9997b7ee593
BLAKE2b-256 checksum
How to use checksums
fab37d79f301a3cb6cb2bd71f25e05bbe9375120aab71081a17afade51804532
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / ralph_ideate-0.2.0-py3-none-any.whl

Download URL ralph_ideate-0.2.0-py3-none-any.whl
Size 45.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
37e24463451a8bb58a0615963825ebb9aee85ecd9128aca071a53c86d4b8406a
BLAKE2b-256 checksum
How to use checksums
db0e036df1683281112441f1c5fcdf9e14ff18ad3ee7310e49c5d9ef8aa747be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page