whatisgithub

What is hermaquette?

chushulsuri/hermaquette — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 5/5LicenseSetup · hard

In one sentence

An AI agent pipeline that turns a text description into a priced, printable 3D model, handling design, payment, and order tracking end to end.

Mindmap

mindmap
  root((Hermaquette))
    What it does
      Text to 3D model
      DFM repair loop
      Vendor quote and payment
    Tech stack
      Next.js
      Python
      Docker Compose
      SQLite
      Stripe
    Use cases
      Prototype a printable object
      Automate manufacturing quotes
      Track order fulfillment
    Audience
      Developers
      Hackathon builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Describe a physical object in plain language and get back a colored, printable 3D model.

USE CASE 2

Automatically check and repair a generated 3D model so it can actually be manufactured.

USE CASE 3

Get a real vendor price quote for a 3D printed object and process payment through Stripe.

USE CASE 4

Track an order after payment and get automated delivery quality checks from photos.

What is it built with?

Next.jsTypeScriptPythonDocker ComposeSQLiteStripe

How does it compare?

chushulsuri/hermaquette0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity5/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Docker Compose, a git submodule, and several third party API keys (fal.ai, Stripe, OpenAI, Sculpteo).

The project's own code can be used freely including commercially, but a bundled submodule keeps its own separate license.

So what is it?

Hermaquette is a hackathon project that turns a written description of a physical object into a colored, 3D printable model, using a team of three AI agents built on a framework called Hermes to do the work from start to finish. You type a sentence describing a non electronic object, and the system researches it, creates concept images, builds a full color 3D model, checks and repairs the model so it can actually be printed, gets a real price quote from a manufacturing vendor, takes a payment through Stripe, and manages what happens after the order is placed. The three agents each have a role. The first, called Hermaquette, is the orchestrator that understands the request, generates concept images, and hands off work to the other two. The second, called Sculptor, builds the full 3D colored model using a service called fal.ai, then runs a repair loop until the design is manufacturable, or marks it as blocked if it cannot be fixed. The third, called Follow-up, tracks the order after payment, checks delivered photos against the design using GPT vision, and drafts any reprint or refund request for a human to approve, since nothing gets sent automatically. The process runs in stages: describing the object, picking a generated concept, building and repairing the 3D model, getting a vendor quote plus a service fee, and finally paying through Stripe in test mode with a human approving any vendor spending. Every step in between is logged in a SQLite database that acts as the single source of truth for the whole order. The project is built with a Next.js web app, a Python service for mesh repair, and a Hermes agent service, all run together using Docker Compose, with API keys needed for the various third party services it depends on. The project's own code is released under the MIT license, though it also includes a separate open source component under its own upstream license. It was built for the Hermes Hackathon 2026.

Copy-paste prompts

Prompt 1
Explain the roles of the three agents in Hermaquette and how they hand off work.
Prompt 2
Walk me through setting up Hermaquette locally with Docker Compose and the required API keys.
Prompt 3
Summarize how the DFM repair loop decides whether a 3D model is manufacturable.
Prompt 4
Help me understand how Hermaquette's order data flows through its SQLite database.

Frequently asked questions

What is hermaquette?

An AI agent pipeline that turns a text description into a priced, printable 3D model, handling design, payment, and order tracking end to end.

What language is hermaquette written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, Python.

What license does hermaquette use?

The project's own code can be used freely including commercially, but a bundled submodule keeps its own separate license.

How hard is hermaquette to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is hermaquette for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.