Just Ralph It (a.k.a. Ralfealo)
Overview
Just Ralph It (JRI) is a software that helps you think through your software project idea, and then to build it with one click. You just have to share your thoughts, and JRI handles the rest.
[!NOTE] To know more about this project vision and motivation, read the concept document.
Feature Roadmap
- Terminal UI
- Requirements gathering interview
- Exploration
- Local shell commands
- Local files, including images
- Web search
- Public URLs, including YouTube videos
- Note taking
- Topic-based context management
- Exploration
- Automated implementation (inspired on the SDLC and the Ralph technique)
- Requirements analysis
- System design
- Development
- Quality assurance
- Deployment
- Maintenance
- Remote execution
- Web UI
- Notes graph visualization
- Hosted platform
Getting Started
0. Prerequisites
- Python >=3.13 or uv
- API key from OpenRouter (the default), any other OpenAI-compatible LLM inference provider, OR a ChatGPT subscription
- Git >=2.x.x
1. Installation
uv tool install just-ralph-it
# Alternative command:
pip install just-ralph-it
2. Setup
Move to a project directory and set it up:
mkdir ./my-project
cd ./my-project
jri init
That creates .jri/settings.yaml. Open it and follow its comments.
3. Usage
# Run the TUI to start a chat session:
jri chat
# Show the notes graph:
jri view
[!TIP] Given that there isn't automated implementation yet, you can hand the generated
.jri/notebook.yamlor.jri/specs/to your favorite coding agent as a starting point for implementation.
Upgrading
uv tool upgrade just-ralph-it
# Alternative command:
pip install --upgrade just-ralph-it
[!WARNING] Until reaching a stable version (>=1.0.0), anything could break from one version to another.
Uninstalling
uv tool uninstall just-ralph-it
# Alternative command:
pip uninstall just-ralph-it
# Remove JRI from the project:
rm -fr /path/to/your-project/.jri
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file just_ralph_it-0.7.0.tar.gz.
File metadata
- Download URL: just_ralph_it-0.7.0.tar.gz
- Upload date:
- Size: 107.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
09e90fc6f24c041b246fae27a51b3319d2f1708492ebbaea1580e1c801afbd66
|
|
| MD5 |
2373311bb46cd7a37248d33ad8824756
|
|
| BLAKE2b-256 |
0d83f819d28e61c34baa55d7c1d279b8d28c6b8ce359f623c4b664b7caf29556
|
File details
Details for the file just_ralph_it-0.7.0-py3-none-any.whl.
File metadata
- Download URL: just_ralph_it-0.7.0-py3-none-any.whl
- Upload date:
- Size: 133.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4d11b19a82fbb50bc212c5beccdab6603245251a90f9c290931504dea25113fa
|
|
| MD5 |
4e31c54429f75b8407c4516d8c8485f9
|
|
| BLAKE2b-256 |
09a6600507f21e8af56a8a05107c1ec04a214f9cf480c99906b63fa18bad40a7
|