Skip to content

# 🐍 OuroDev **OuroDev** is the **ouroboros of programming** β€” an autonomous, next-generation developer agent that **never sleeps**. It loops endlessly through tasks: fetching, planning, coding, evaluating, and retrying β€” until the job is done βœ…. > πŸ’‘ *"You’ll never need a junior developer again."* ---

Notifications You must be signed in to change notification settings

ShuoShenDe/OuroDev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐍 OuroDev

OuroDev is the ouroboros of programming β€”
an autonomous, next-generation developer agent that never sleeps.

It loops endlessly through tasks: fetching, planning, coding, evaluating, and retrying β€”
until the job is done βœ….

πŸ’‘ "You’ll never need a junior developer again."


✨ Key Features

  • πŸ”Œ Pluggable Sources – Connect to Jira, Lark, Monday.com, or any project management platform.
  • 🧠 LLM-Powered Decomposition – Use Cursor, Claude, Gemini, DeepSeek, or your own model to break down tasks into executable steps.
  • πŸ“Š Complexity Scoring – Each task is scored from 0–100 with configurable thresholds for auto-abort or escalation.
  • πŸ€– Autonomous Execution – Clone repos, switch branches, apply code changes, and submit merge requests automatically.
  • πŸ“ Code Quality Evaluation – Aggregate linters + LLM review into a unified quality score and MR comment.
  • πŸ”„ Self-Healing Loop – Parse CI/CD pipeline results, regenerate tasks, and re-enter the loop if failures occur.
  • βš™οΈ Orchestration Ready – Built to integrate seamlessly with Airflow or run standalone with the built-in runner.
  • πŸͺ Hookable at Every Step – Insert custom logic at before_*, after_*, or on_error_* stages.

πŸ“‚ Project Structure


πŸ”„ Workflow

flowchart TD
    A[Fetch Task from Jira/Lark/Monday] --> B[Decompose with LLM]
    B --> C[Complexity Scoring (0-100)]
    C -->|Below threshold| D[Apply Changes via Executor]
    D --> E[Submit MR to GitHub/GitLab]
    E --> F[Code Quality Evaluation]
    F --> G[CI/CD Pipeline Feedback]
    G -->|Fail| A
    G -->|Pass| H[Done βœ…]
Loading

⚑ Quick Start

1️⃣. Install

pip install ourodev

2️⃣. Configure

export OURODEV_JIRA_TOKEN=xxx export OURODEV_OPENAI_KEY=xxx

...other settings...

3️⃣. Run locally

ourodev run --source=jira --executor=cursor_cli

4️⃣. Orchestrate with Airflow

cp ourodev/pipelines/airflow/dags/ourodev_main_dag.py $AIRFLOW_HOME/dags/ airflow dags trigger ourodev_main

🌟 Roadmap

Add more task sources (Asana, Trello, Notion)

Expand LLM backends (OpenAI o1, Anthropic Sonnet, etc.)

Add richer quality metrics (coverage, performance)

Multi-agent collaboration support

Web dashboard for monitoring loops

πŸ“Š Demo

πŸ‘‰ (Coming soon: GIFs and screenshots of OuroDev in action)

[Placeholder for your demo uploads: task ingestion β†’ plan generation β†’ MR creation β†’ CI feedback loop]

🀝 Contributing

Contributions are welcome! Please open issues or PRs β€” OuroDev is designed to be pluggable at every layer.

🐍 Philosophy

OuroDev embodies the Ouroboros: a self-sustaining loop where a developer agent continuously evolves code, learns from failures, and never stops improving.

It’s not just automation. It’s the next generation programmer.


πŸ‘¨β€πŸ’» Author

Created with ❀️ by Shuo Shen


β˜• Support the Project

This project is open-source and built with love (and way too much coffee).
If OuroDev saves you some time or inspires you, and you’d like to say thank you β€”
here are some ways you can support me:

  • πŸ’³ PayPal
  • 🧧 Or simply drop me a kind message β€” it means a lot!

Your encouragement helps me keep improving OuroDev and sharing it with the community. πŸ™Œ

logo

About

# 🐍 OuroDev **OuroDev** is the **ouroboros of programming** β€” an autonomous, next-generation developer agent that **never sleeps**. It loops endlessly through tasks: fetching, planning, coding, evaluating, and retrying β€” until the job is done βœ…. > πŸ’‘ *"You’ll never need a junior developer again."* ---

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages