Show HN: Borea: generate typesafe SDKs from OpenAPI

[logscore]

Today we publicly launch Borea on Product hunt and Hackernews.

The SDK gen ecosystem is a mess. Either the tools don't work or they are way too expensive. We aim to fix that with an open source solution that gives you all the functionality you want without killing your wallet or giving you a headache.

Our generators give you typed, documented, idiomatic SDKs that enable you to add custom code implementations that wont be overwritten on regeneration.

We support Python and are working to release Typescript support asap as well as an all in one cli to generate, test and publish multiple SDKs with one command

Check out our PH launch [1] and star our Github repo [2]. If you want to help us build this, we are open to any and all contributions. Check out our dedicated Discord server [3] to build with us or just chat!

[1] https://www.producthunt.com/products/borea [2] https://github.com/Borea-dev/python-client-generator [3] https://discord.gg/qpdxeF6wrK

[skilbjo]

hi, few questions,

-who is your ideal user/customer? what stack are they using, and why do they use you?

-why did you decide to work on this? (ie, what inspired you?)

-how do you compare against openapi templated/generated SDKs? ie i use openapi-typescript (https://openapi-ts.dev/) and it is fantastic

-there seem to be some VC backed companies in the space: https://news.ycombinator.com/item?id=40147281, what is your edge?

-as someone who tried to maintain a few SDKs in my non-familiar languages (go, java, c#), i think i definitely see a paid use case for giving the problem to someone else who can maintain a quality SDK, but there are already 3-4 VC backed companies in the space, and i think the existing free tools are not bad if you spend some time with them, what is the gap/thing they're missing?

ty, john

[bauchdj]

Hi John,

ICP: developers and teams that want to generate simple, extendable SDKs. Our goal is to bring a successful successor to the OpenAPI generator project. Most OpenAPI open source projects come and go. We want to offer a open source SDK generator suite that is dependable, yet simple.

Why: We met with many developers who want an open source successor to OA generator that generated readable code and can be extended very easily. We partnered with Trieve from YC W24 to build the Python SDK generator to start.

-2 main differences. Our goal is to bring a core open source solution across languages and to keep all the generated code human readable and easy to extend. We recognize there are projects in the space that work great. However, finding the best solution for each language is different and time consuming.

Edge: Open source first and community driven. Simpler cleaner code. Extendable by design.

There are solutions but each one has it limitations. We can generate an SDK that works, while they current paid solutions will say the OpenAPI doc is invalid. We can generate human readable code, they don't. We want to support all languages for free, paid solutions don't. Open source projects that solve one language are often abandoned or forgotten and are extremely hard to find. Then, you have to determine which one you will use for each language.

Hope that helps,

David, Co-founder at Borea

[DataOverload]

There are many SDK generators out there (even OSS) - what makes you special?

[logscore]

Our primary advantage right now is extensibility and simplicity. We are working with users that want to implement features that cant be generated with current generators and we enable them to implement those. Our generator does work for those basic use cases when you want a client to interact with an API, but if you need something more, like state management, sse, etc, we make the SDK easy to work with and extend.

If you've used some oss generators, their code is often a complete headache to just read. OpenAPI generator is a good example.

Hope that answers your question :P