founden (Python SDK)
Build and run your company from your own code with one API key. Founden builds the full product (website, app, admin) in the cloud and returns a live link.
Install
pip install founden
Usage
from founden import Founden
client = Founden("omk_your_key_here")
# Start a build
build = client.build("Build a booking site for my dental clinic with online payments")
execution_id = build.execution_id
# Stream live progress (events: build_step, build_complete, build_done, orphaned_build, build_error)
for event in client.stream(execution_id):
print(event["event"], event["data"])
# Status + live preview URL
status = client.status(execution_id)
print(status.preview_url)
# Send a follow-up instruction (free within a build)
client.message(execution_id, "Add a contact form on the homepage")
# Stop a running build
client.stop(execution_id)
Async client:
from founden import AsyncFounden
async with AsyncFounden("omk_your_key_here") as client:
build = await client.build("Build a SaaS marketing site with pricing and a waitlist")
await client.message(build.execution_id, "Add testimonials")
Methods
| Method | Endpoint | Description |
|---|---|---|
build(prompt, **kwargs) |
POST /v1/builds |
Start a build (company_id=... to target an existing company). 1 credit. |
status(execution_id, **kwargs) |
GET /v1/builds/{id} |
Status + live preview URL. |
message(execution_id, prompt, **kwargs) |
POST /v1/builds/{id}/message |
Follow-up instruction. Free within a build. |
stop(execution_id, **kwargs) |
POST /v1/builds/{id}/stop |
Stop a running build. |
stream(execution_id) |
GET /v1/builds/{id}/stream |
Generator of SSE build events. |
Every call returns a FoundenResult (.success, .data, .error, .metadata, .credits_used, plus .execution_id, .status, .preview_url helpers). One omk_ key works across every O-mega product. Get yours at https://founden.ai/app/build.
License
MIT
Metadata
Release files for founden 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| founden-0.1.0.tar.gz | 4.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| founden-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.7 kB
Release files / founden-0.1.0.tar.gz
| Download URL | founden-0.1.0.tar.gz |
|---|---|
| Size | 4.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
672ac44a69db12cd7e01668fd865462906318e0524805e45fb2c8d9c9776d7d7
|
|
BLAKE2b-256 checksum How to use checksums |
f5d808a248073e82102582c2378b9397af9ff114051f509303f2ec6104266eca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.2
|
Release files / founden-0.1.0-py3-none-any.whl
| Download URL | founden-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c7c2b05b7b2ed473242dec8c899c69ca6e2099397c816eb0577dd76468d7ae25
|
|
BLAKE2b-256 checksum How to use checksums |
b47f741421a47e68ac67d428627e51a293aa1cb03be478a1163b14712b9b1695
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.2
|