Skip to content
View herakles-dev's full-sized avatar
💭
Follow please! I Love Linux <3
💭
Follow please! I Love Linux <3

Block or report herakles-dev

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
herakles-dev/README.md
Michael Piscitelli — herakles.dev

**Solo builder shipping complex, cross-platform systems | Linux | ANDROID | Windows ** I run an agentic development practice at herakles.dev and I'm launching keymakers.ai.

herakles.dev keymakers.ai Chicago Claude Code profile views

terminal: michael@herakles-dev


1,813 contributions in the last year

Pac-Man eating my contribution graph

I'm Michael — Herakles. Fiber-optic network designer by day, and since mid-2025 a self-taught AI-agentic engineer by night — building my own orchestration engine one 3am session at a time. The engineering mindset stuck. The credential didn't.

The origin story is dumb and true: I automated my telecom crew's grunt work so well that we out-earned the managers. So the company cut our per-foot rate and kept the difference. That's the whole reason I do this now — I'd rather build the leverage and own it.

So I do. Everything here is self-hosted, runs in production, and the claims check out. I lead the agents, review the diffs, and steer the system — more conductor than typist, though I still write plenty of code by hand. I don't ship demos.

Live right now
  • fine-print.org — paste a Terms of Service, get back what you're actually agreeing to. Runs on my own multi-provider LLM gateway, not a single rented API.
  • subfold.pro — a music-reactive visual instrument: real-time 3D fractals that fold to the beat.
  • nightjar — an offline Android app that hides data in sound and images, and ships the detectors that catch it. Open source, MIT.
Merged into the wild

Auto-updated weekly by a GitHub Action I own — external PRs that maintainers merged, newest first. No hand-editing.

Two of those are original Lean 4 proofs closing Erdős problems in Google DeepMind's formal-conjectures — one of them fills a real gap in Mathlib. The third put a Claude Code workflow of mine into a 265k-star repository.

What I'm building

Bare-metal infrastructure, agent orchestration, whitehat security research, formal math, GPU visuals, a production SaaS with a real customer. Not a one-trick stack. Each card below sits on its own clock — the description swaps in on a loop, staggered per card, no two flipping in sync.

nine self-animating project cards

v11, typesafe-claude-kit and nightjar are public, subfold.pro is live, and math-proof lives at erdos672-four-squares-lean. The rest are private or local — ask if you want a look.

How v11 actually enforces itself — task-as-truth, write-gate hooks, adversarial review pairing, autonomy

A raw write from an agent doesn't just land — it has to clear a gate first, and every gate outcome feeds back into how much autonomy that agent earns next time.

%%{init: {'theme': 'base', 'themeVariables': {
  'primaryColor': '#1f1f25',
  'primaryTextColor': '#e4e4e7',
  'primaryBorderColor': '#8E74F2',
  'lineColor': '#8E74F2',
  'secondaryColor': '#17171b',
  'tertiaryColor': '#17171b',
  'background': '#17171b',
  'mainBkg': '#1f1f25',
  'nodeBorder': '#8E74F2',
  'clusterBkg': '#17171b',
  'edgeLabelBackground': '#17171b',
  'fontFamily': 'JetBrains Mono, ui-monospace, monospace'
}}}%%
flowchart LR
    T[Task created] --> W{Write-gate hook}
    W -->|blocks until reviewed| I[Agent implements]
    I --> R[Adversarial review pairing]
    R -->|FAIL| I
    R -->|PASS| C[Task marked complete]
    C --> A[Autonomy tracking]
    A -.->|earns trust over time| W
Loading

Four moving parts, each worth its own look:

Task-as-truth

Tasks are the single source of truth for what's actually done — not a status the agent reports about itself. If it's not marked complete in the task system, it didn't happen, no matter what the agent's own summary claims.

Write-gate hooks

The mechanism that makes task-as-truth real, not just a stated policy: a hook intercepts every write before it lands and blocks anything that hasn't gone through review. An agent can't just skip the gate by not mentioning it.

Adversarial review pairing

Every non-trivial task gets paired with an independent review pass before it's allowed to complete — a second look built into the pipeline itself, not something that has to be remembered or requested.

Autonomy tracking

Earned, not granted up front. A project starts at the most-supervised level and only escalates to less oversight after an actual track record — the system has to watch itself work before it's trusted to work less-watched.

Hekaton — the vLLM upgrade that taught me to always ship a rollback plan

Hekaton is my autonomous coding harness: a customized DeepSeek Harness running my V11 hooks unmodified, driving a tiered ensemble of Qwen coder models. It's portable now — no fixed box. It rents a cloud GPU (H100 or GH200), runs a mission, and tears itself down, with every dollar logged. Latest result: a best-of-3 fan-out took a 12-task polyglot suite from 6/12 to 10/12 for about $4.

Back when it ran on a single rented GH200, I bumped vLLM by one version with no rollback path. It broke multi-model serving on the GH200 mid-session, and I had no fast way back to the last-known-good state — just a slow rebuild. Every dependency bump now ships with a tested rollback plan before it goes anywhere near rented hardware. Expensive lesson, cheap fix.

math-proof — 48 machine-checked Lean proofs in 8 days, two closing real Erdős problems

Formal math was new territory for me going in. math-proof produced 48 Lean 4 proofs with zero sorrys — every one machine-verified, not just "looks right." Two of them closed actual open problems in Google DeepMind's formal-conjectures repo: erdos_399.variants.cambie (an elementary mod-8 argument) and erdos_672.variants.euler, which links out to a standalone proof repo, erdos672-four-squares-lean. Both merged.

Zeus Terminal — how all of this gets built

I'm talking to Claude through it right now. Zeus Terminal is a self-hosted, mobile-first web terminal I built to replace Termux: tmux persistence, WebSocket transport, 804 tests, continue a session from my phone to my laptop without losing state. It's a session multiplexer — every project gets its own window, several Claude Code agents run in parallel, and a /handoff command lets me spin up a fresh session mid-task without losing context. My daily driver, not a side project.

Zeus Terminal: three live Claude Code sessions side by side, with the task sidebar

This README, the Actions that keep it updated, and everything else on this page were built from inside it.

And the box underneath all of it — plus what it's actually doing right now, live, recomputed on every fetch, straight off the same machine (no repo commit involved, unlike everything else on this page):

neofetch: the box this all runs on live Hercules platform activity

A few things that don't fit on a résumé
  • Built a Pac-Man ghost AI that lives on my Android homescreen and chases my taps around — 28KB APK, runs at 2-3% CPU, entirely pointless and I love it.
  • My grocery price tracker bypasses Cloudflare to watch 900+ items at the store down the street, because I got tired of guessing what's actually on sale.
  • A phone-to-phone acoustic covert data channel, with its own on-device detector, because I wondered if two phones could talk without a network.
  • My login page has custom GLSL liquid shaders for no reason other than it looked cool at 2am and I didn't undo it.
Stack

Python, TypeScript, Rust, Lean 4, Bash, Docker, PostgreSQL, FastAPI, Next.js, CUDA, Kotlin, Linux

By the numbers

All three cards below are generated by my own script, not a third-party render service — source. The last one that wasn't broke the week I rebuilt this page. Zero left now.

stats top languages contribution streak
Latest pushes

Auto-updated — my own repos, most recently pushed.

  • nightjar — Offline Android app demonstrating covert data transmission (hiding data in sound and images) and the detection techniques that can catch it. Acoustic data-over-sound modem, image/audio steganography, passive detector.
  • typesafe-claude-kit ⭐ 1 — Claude Code kit for TypeSafe (Jev): agents, skill, client, calibration tools
  • herakles-daimon — AI-curated, mood-responsive media platform built with the Gemini Live API
  • opensource-pipeline ⭐ 2 — Safely open-source any project with Claude Code. 3-agent pipeline that strips secrets, verifies sanitization, and generates professional docs. Just say /opensource fork my-project.
  • v11 ⭐ 1 — Spec-driven orchestration protocol for reliable multi-agent Claude Code development — task-as-truth, write-gate hooks, adversarial review pairing, autonomy tracking. Installable.

One more thing — Claude left a review.

A Google-style review of working with me, written by Claude

Still up late most nights. Still shipping (just watch) If you've made it this far, FOLLOW ME!

herakles.dev · keymakers.ai · hello@herakles.dev

Pinned Loading

  1. nightjar nightjar Public

    Offline Android app demonstrating covert data transmission (hiding data in sound and images) and the detection techniques that can catch it. Acoustic data-over-sound modem, image/audio steganograph…

    Kotlin 1

  2. typesafe-claude-kit typesafe-claude-kit Public

    Claude Code kit for TypeSafe (Jev): agents, skill, client, calibration tools

    Python 1

  3. herakles-github-agent herakles-github-agent Public

    Human-supervised agentic architecture for rigorous open source contributions

    1

  4. claude-code-agents claude-code-agents Public

    Curated, transferable Claude Code subagents in installable packages — orchestration, engineering, security, devops — plus a CLAUDE.md template for multi-agent projects.

    1

  5. tos-analyzer tos-analyzer Public

    AI-powered Terms of Service analyzer - summarize, score, and understand legal documents

    TypeScript 1

  6. opensource-pipeline opensource-pipeline Public

    Safely open-source any project with Claude Code. 3-agent pipeline that strips secrets, verifies sanitization, and generates professional docs. Just say /opensource fork my-project.

    Shell 2