Show HN: Sideko – Hybrid deterministic/LLM generator for API SDKs and docs

Hi HN, I’m Patrick. Elias, Kevin, and I are building Sideko (https://sideko.dev), a new type of code generator for building and maintaining API client SDKs from OpenAPI specs.

Traditional SDK generators rely on static templates that produce rigid, machine-generated code. When the API changes, these generators completely overwrite the SDK, destroying any custom modifications developers have made. The result is brittle code that looks artificial and requires constant manual rework.

Our approach uses structured pattern matching queries instead of templates. These queries analyze the existing codebase to understand its structure and intent, then make small updates while preserving custom changes. When we regenerate code, the system recognizes what developers have modified and works around those changes rather than overwriting them. The pattern matching enables our hybrid workflow where deterministic codegen establishes the foundation, LLMs enhance specific components, and the system maintains both the automatically generated and the human-modified code.

Our Hybrid SDK Generation Approach

Workflow: Our system starts with deterministic codegen that generates the base SDK structure, then uses LLMs to enhance specific components where adaptability adds measurable value, while agent rules enforce consistency through type checking and integration tests against mock servers.

Summary: The key advantage is that LLM edits are retained across code regenerations while the deterministic code stays automatically synced with API changes. Language-specific rules for Python and TypeScript guide both LLM modifications and testing to ensure quality and consistency throughout the development cycle.

You can quickly try it out from your terminal:

  Install: npm install -g @sideko/cli
  Login: sideko login
  Initialize: sideko sdk init
  Prompt: “Add a new function that…”

We’d love to hear your thoughts!

Comments URL: https://news.ycombinator.com/item?id=45025678

Points: 10

# Comments: 3

https://github.com/Sideko-Inc/sideko/tree/main/releases/determinism-plus-llms