Just Ralph It (a.k.a. Ralfealo)
Overview
Just Ralph It (JRI) is currently an agent harness to think ideas through and write specs that match what you actually mean. In the future, it will not just write specs, but also autonomously ship and maintain the entire software.
[!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 Vercel AI Gateway (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
# See all available commands:
jri --help
[!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
1 maintainer
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.10.2.tar.gz.
File metadata
- Download URL: just_ralph_it-0.10.2.tar.gz
- Upload date:
- Size: 133.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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 |
b3c6bcf4c21f3ac05f16755fe2ec408f863954891276bf61fde006f4bcdbb7ad
|
|
| MD5 |
a5356a47e424f5333e908519d8a50790
|
|
| BLAKE2b-256 |
8a8a28bf866a53b522277956aa62e70c7431bcc8d70db314c49a80f28c851f6d
|
File details
Details for the file just_ralph_it-0.10.2-py3-none-any.whl.
File metadata
- Download URL: just_ralph_it-0.10.2-py3-none-any.whl
- Upload date:
- Size: 163.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.8 {"installer":{"name":"uv","version":"0.12.8","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 |
7fd2cfe333894cefeeb6ddce538e59dec6d3090447059344b9a823a0711e1e79
|
|
| MD5 |
7a86fcc73ffa706e9b3b6f7131398659
|
|
| BLAKE2b-256 |
79ddb254baed237730e151d007be308d23d3f10b1b0973aeb41b01619a3855e0
|
