Metadata-Version: 2.4
Name: founden
Version: 0.1.0
Summary: Founden Python SDK. Build and run your company from your AI agent with one API key.
Project-URL: Homepage, https://founden.ai
Project-URL: Documentation, https://founden.ai/mcp
Project-URL: Repository, https://github.com/O-mega-Enterprise/founden-mcp
License: MIT
Keywords: ai-agent,company-builder,founden,no-code,website-builder
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# founden (Python SDK)

Build and run your company from your own code with one API key. [Founden](https://founden.ai) builds the full product (website, app, admin) in the cloud and returns a live link.

## Install

```bash
pip install founden
```

## Usage

```python
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:

```python
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
