←back to thread

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

(github.com)
26 points pmkelly4444 | 1 comments | 26 Aug 25 12:36 UTC | HN request time: 0s | source

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…”
Repo is here: https://github.com/Sideko-Inc/sideko

We’d love to hear your thoughts!

Show context
dlahoda ◴[26 Aug 25 18:42 UTC] No.45030545[source]▶
we have openapi.

one of openapi methods inputs pk signed binary protobuf message and handles inner result which may be custom error code(after unwrapping http code).

some other openapi method is ws upgrade. data over ws has json schema for messages, but no any api generated. we could have sse and have similar problem.

other teams writes solana contact and generates its client(called anchor).

so we have rust, and generate a lot of ts.

after, somebody glues manually all these parts.

and after somebody supposely adapts these to react.

so out problem not docs, but a lot of manula glue to maintain. which in theory could be ai generated.

replies(1): >>45031050 #
1. pmkelly4444 ◴[26 Aug 25 19:24 UTC] No.45031050[source]▶
And you're stuck maintaining the glue by hand because no generator understands the relationships between all these different systems.