founden 0.1.0

Founden Python SDK. Build and run your company from your AI agent with one API key.

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