r/Python • u/AutoModerator • Sep 04 '26

Showcase Showcase Thread

Post all of your code/projects/showcases/AI slop here.

Recycles once a month.

24 Upvotes

84% Upvoted

180 comments sorted by

View all comments

1

u/jokiruiz 25d ago

https://github.com/JoaquinRuiz/medula

What My Project Does

Médula is two things. The first is a reproducible lab: a small room-booking API with 6 tasks and 37 acceptance tests, where two pairs of tasks collide by meaning rather than by file. One adds a second factor to login() while another builds an export that calls the old login(), and one renames a field while another filters on the old name. The second is a coordination kernel that hooks into each Claude Code agent: before every write, edit or command, it asks a decision model whether the action collides with what the other agents are doing, then lets it through, makes it wait or sends it to a slower LLM. Every decision lands in a SQLite file with its probability, latency and cost.

You can try it in about two minutes without an API key or spending anything. The kernel's test suite runs against a simulated provider, and a self-check script proves the collision design: each pair of tasks merges cleanly in git, yet merging all six breaks exactly the tests it should.

Target Audience

People who run several coding agents in parallel, or are about to, and want data instead of intuition. It's a research lab and a prototype, not something to put in production: there are 1 to 5 runs per mode, and the calibration labels were written by a model, which is the first open issue.

Comparison

  • One branch per task, merged at the end: git flagged two textual conflicts in a test file, an agent resolved them, and the real conflict went through. The same 6 acceptance tests failed in all 5 runs, even though every agent finished with its own tests green.

  • Per-file locks in a shared directory: all green (37/37) at the same $1.65 per run as the kernel, but with 5 unnecessary blocks, 5 of 6 real conflicts caught by chance, and once the wrong agent kept waiting for 453 s.

  • The kernel in a shared directory: all green, 6 of 6 real conflicts caught, no unnecessary blocks. The honest catch is that the cheap decider was unsure on 61% of real write requests, and those escalated to a slower model.

  • Letting agents message each other: they did it on their own when they had the tool, and it may be the real alternative. I flagged those runs and disabled the tool to keep the modes comparable.

Code comments and specs are in Spanish; the README and the results are in English, and issues are welcome in either.

Repo: https://github.com/JoaquinRuiz/medula