Skip to main content
Documentation

Hephaestus

An open-source AI mentor for software teams. It reads the work developers already do against the engineering practices their project cares about, and writes back feedback they can act on.

Read the user guideInstall it yourself
Four cards from one change — an issue, a pull request, a review and the merge — each with the practice feedback Hephaestus attached to it.Four cards from one change — an issue, a pull request, a review and the merge — each with the practice feedback Hephaestus attached to it.

Pick the guide that matches your role

Every page says who it is for in its first line.

You use Hephaestus

User guide

What the feedback is, where it reaches you, and how to talk it through.

You run a deployment

Admin guide

Install it, connect a source and an AI provider, and keep it healthy.

You change the code

Contributor guide

Set up the services, follow the standards, and ship a change.

What Hephaestus does​

Specific feedback on how the work was done

Practice feedback

Hephaestus can review pull requests, merge requests, and issues against the engineering practices chosen for a workspace. Feedback links back to evidence in the work.

  • Points to evidence in the work
  • Names the missing decision or working-practice gap
  • Suggests a concrete next step
How practice feedback works

Talk through feedback and recent work

Chat with Heph

Heph can use recent project activity and feedback you have received as context.

  • Ask a question about a recent change
  • Question a suggestion or compare possible next steps
  • Use the web app or a Slack direct message
How to chat with Heph

Your repositories, practices, and settings

Workspace controls

Workspace admins choose the source repositories, project context, practice catalog, and AI model.

  • Connect GitHub or GitLab
  • Add selected Slack channels and Outline documents as context
  • Manage members and teams
Understand workspaces