Skip to main content

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)

Source distribution for founden 0.1.0
File Size Uploaded
founden-0.1.0.tar.gz 4.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for founden 0.1.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page