Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

romyq-0.1.1.tar.gz (24.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

romyq-0.1.1-py3-none-any.whl (26.8 kB view details)

Uploaded Python 3

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

Hashes for romyq-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c493f4c0d6ecf1ad1cd6f581fea5679e511fed7736c5ac8c4eba9a74d5bc4a39
MD5 dd9261e7d353a180782f9fd7af7377b4
BLAKE2b-256 3dacbecd997afc5b3dcf00e45a834e5dac2d06cb3afc9467ce4e6b8238ee2190

See more details on using hashes here.

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

Hashes for romyq-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 28d4712ba03dd4a409be5e29b104a8d06c040d4cb7d7fca1b11b951c1cbd7c71
MD5 1172ef6a3ba0359ab59eee0362d5250f
BLAKE2b-256 f71ec11633b8332a6010ac32999d91d4207c9a59f3f5fb6350a25994b84537b0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page