Autonomous AI software project manager
Project description
Romyq
Autonomous AI software project manager.
Give Romyq a software goal. It plans, codes, commits, audits, and keeps improving until you stop it.
Screenshot coming soon —
romyq ui(Textual TUI)
Install
pip install romyq
60-Second Quick Start
mkdir my-project
cd my-project
git init
cp .env.example .env
# Open .env and add your DEEPSEEK_API_KEY
romyq attach
# Edit mission.md — describe what you want built
romyq doctor
romyq run
That's it. Romyq takes over from here.
What Happens Next
- Romyq reads
mission.md - DeepSeek generates a task plan
- Claude Code implements each task
- Every successful task creates a git commit
- Romyq audits progress and keeps improving the project
Commands
| Command | Description |
|---|---|
romyq attach |
Initialize Romyq in the current directory |
romyq doctor |
Validate environment and configuration |
romyq run |
Start the autonomous loop |
romyq ui |
Launch the Textual TUI dashboard |
romyq status |
Show current mission and task state |
Configuration
Copy the example file and fill in your keys:
cp .env.example .env
.env.example:
DEEPSEEK_API_KEY=
ROMYQ_CLAUDE_TIMEOUT=1800
Advanced Usage
Run against an existing repository:
romyq attach /path/to/repo
romyq run /path/to/repo
Set workspace via environment variable:
ROMYQ_WORKSPACE=/path/to/repo romyq run
Requirements
- Python 3.10+
- Claude Code installed and authenticated
- DeepSeek API key
- Git initialized in your project directory
Changelog
See CHANGELOG.md.
License
MIT
Project details
Release history Release notifications | RSS feed
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 romyq-0.1.1.tar.gz.
File metadata
- Download URL: romyq-0.1.1.tar.gz
- Upload date:
- Size: 24.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c493f4c0d6ecf1ad1cd6f581fea5679e511fed7736c5ac8c4eba9a74d5bc4a39
|
|
| MD5 |
dd9261e7d353a180782f9fd7af7377b4
|
|
| BLAKE2b-256 |
3dacbecd997afc5b3dcf00e45a834e5dac2d06cb3afc9467ce4e6b8238ee2190
|
File details
Details for the file romyq-0.1.1-py3-none-any.whl.
File metadata
- Download URL: romyq-0.1.1-py3-none-any.whl
- Upload date:
- Size: 26.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
28d4712ba03dd4a409be5e29b104a8d06c040d4cb7d7fca1b11b951c1cbd7c71
|
|
| MD5 |
1172ef6a3ba0359ab59eee0362d5250f
|
|
| BLAKE2b-256 |
f71ec11633b8332a6010ac32999d91d4207c9a59f3f5fb6350a25994b84537b0
|