Metadata-Version: 2.4
Name: creatoros
Version: 1.0.0
Summary: Fast, zero-dependency Web-to-Markdown extraction, autonomous agent live web search, and neural text-to-speech for LLMs and RAG pipelines.
Author-email: CreatorOS Team <support@thecreatoros.dev>
License-Expression: MIT
Project-URL: Homepage, https://thecreatoros.dev
Project-URL: Documentation, https://thecreatoros.dev/docs
Project-URL: Repository, https://github.com/CreatorOS/creatoros-python
Project-URL: Bug Tracker, https://github.com/CreatorOS/creatoros-python/issues
Keywords: web-to-markdown,html-to-markdown,rag,llm,web-scraping,langchain,llama-index,crewai,web-search,text-to-speech
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# CreatorOS Python SDK

Official Python SDK for [CreatorOS](https://thecreatoros.dev) — High-throughput Web-to-Markdown extraction, autonomous multi-URL agent search, and studio-grade AI text-to-speech.

**Zero external dependencies.** Works on standard Python 3.8+ (`urllib` based, zero conflicts with Pydantic/Torch/LangChain).

---

## Installation

```bash
pip install creatoros
```

---

## Quickstart

### 1. Instant Web-to-Markdown Extraction
Extract noise-free Markdown with article metadata stripped of navigation, ads, and tracker boilerplate:

```python
import creatoros

# Free tier (no key required for up to 20 daily calls)
markdown = creatoros.extract("https://news.ycombinator.com")
print(markdown)
```

### 2. Autonomous Agent Live Web Search
Search the live web and retrieve structured results with pre-extracted content from top matches:

```python
import creatoros

results = creatoros.search("FastAPI tutorial 2026", limit=3)
for hit in results.get("results", []):
    print(f"[{hit['rank']}] {hit['title']} -> {hit['url']}")
```

### 3. Neural English Text-to-Speech
Generate human-cadence English speech:

```python
import creatoros

audio_bytes = creatoros.speak(
    text="Welcome to CreatorOS. Clean markdown extraction for autonomous agents.",
    voice="anna",
    output_file="welcome.wav"
)
```

---

## Using with Developer Passes (High Concurrency)

If you have an active CreatorOS Developer Pass, provide your key via parameter or the `CREATOROS_API_KEY` environment variable:

```python
import os
from creatoros import CreatorOS

client = CreatorOS(api_key="YOUR_CREATOROS_PASS_KEY")

# High-concurrency extraction (up to 500,000 monthly credits)
doc = client.extract("https://example.com")
```

---

## LangChain Integration

CreatorOS provides drop-in tools compatible with LangChain, AutoGen, and CrewAI:

```python
from creatoros.langchain import CreatorOSExtractTool, CreatorOSSearchTool

extract_tool = CreatorOSExtractTool()
search_tool = CreatorOSSearchTool()

# Use inside LangChain Agent
tools = [extract_tool, search_tool]
```

---

## License
MIT © [CreatorOS](https://thecreatoros.dev)
