Metadata-Version: 2.4
Name: talocode
Version: 0.1.1
Summary: Unified Python client for Talocode Cloud APIs — Skills, Agent Browser, SearchLane, InvoiceLane, GeoLane, and Cloud billing
Author: Talocode
License: MIT
Project-URL: Homepage, https://github.com/talocode/stacklane
Project-URL: PyPI, https://pypi.org/project/talocode/
Project-URL: Documentation, https://docs.talocode.site
Keywords: talocode,cloud,api,skills,agent-browser,search,talocode
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Talocode (unified cloud client)

**Unified Python client for Talocode Cloud** — Skills, Agent Browser, SearchLane, InvoiceLane, GeoLane, and cloud billing/projects.

Part of **[Talocode](https://talocode.site)** — open tools people trust; sell hosted power behind them.

| | |
|--|--|
| **Package** | `pip install talocode` |
| **Cloud API** | `https://api.talocode.site` |
| **Auth** | `TALOCODE_API_KEY` (Bearer) |
| **Repo** | [github.com/talocode/stacklane](https://github.com/talocode/stacklane) |
| **Docs** | [docs.talocode.site](https://docs.talocode.site) |
| **License** | MIT |

---

## Why this package?

Talocode Cloud exposes many product namespaces under one base URL. This client gives you **one import** and stdlib-only HTTP for:

- **Skills** — generate installable AI skill packs from GitHub/docs/text; export for Cursor / Claude
- **Agent Browser** — check, screenshot, extract, analyze pages
- **SearchLane** — agent web search, news, research with citations
- **InvoiceLane** — extract / validate invoices & receipts
- **GeoLane** — AI-visibility / GEO audit & compare
- **Cloud** — pricing, projects, wallet, usage

Dedicated packages exist for deep product CLIs (`talocode-tera`, `talocode-searchlane`, `tradia`, …). Use **`talocode`** when you want the whole control plane from Python.

---

## Install

```bash
pip install -U talocode
```

Requires **Python 3.10+**. No third-party runtime dependencies.

---

## Quickstart

```python
import os
from talocode import TalocodeClient

client = TalocodeClient(api_key=os.environ["TALOCODE_API_KEY"])
# base_url default: https://api.talocode.site

print(client.health())
print(client.cloud_pricing())

# Skills — GitHub profile → SKILL.md pack (80 credits)
skill = client.skills_generate_github_profile("octocat")

# Agent Browser — structured page extract
page = client.agent_browser_extract("https://example.com", include_links=True)

# SearchLane — web search (5 credits)
hits = client.searchlane_query("MCP agent tools", limit=5)

# InvoiceLane
doc = client.invoicelane_extract("Invoice #123 Total $50.00")

# GeoLane
audit = client.geolane_audit("https://example.com")
```

### Environment

| Variable | Default | Purpose |
|----------|---------|---------|
| `TALOCODE_API_KEY` | — | API key (required for most routes) |
| `TALOCODE_BASE_URL` | `https://api.talocode.site` | API host |

---

## Product APIs (this client)

### Skills (`/v1/skills/*`)

| Method | Credits (typical) |
|--------|-------------------|
| `skills_generate_github_profile(username)` | 80 |
| `skills_generate_github_repo(repo_url)` | 100 |
| `skills_generate_docs(url)` | 100 |
| `skills_generate_text(name, content)` | 40 |
| `skills_export_cursor(skill)` | 10 |
| `skills_export_claude(skill)` | 10 |
| `skills_health()` | — |

### Agent Browser (`/v1/agent-browser/*`)

- `agent_browser_check(url, screenshot=False, vision=False)`
- `agent_browser_screenshot(url, full_page=False, width=1280, height=720)`
- `agent_browser_extract(url, include_images=False, include_links=False)`
- `agent_browser_analyze(url, analysis=None)`
- `agent_browser_health()`

### SearchLane (`/v1/searchlane/*`)

| Method | Credits |
|--------|---------|
| `searchlane_query(query, limit=10)` | 5 |
| `searchlane_news(query, limit=10)` | 8 |
| `searchlane_research(query, limit=10, fetch_pages=True)` | 30 |
| `searchlane_health()` | — |

Prefer `pip install talocode-searchlane` for a focused SearchLane-only client + CLI.

### InvoiceLane (`/v1/invoicelane/*`)

- `invoicelane_extract(text, type=None)`
- `invoicelane_validate(document_type, fields)`
- `invoicelane_health()`

### GeoLane (`/v1/geolane/*`)

- `geolane_audit(url)`
- `geolane_compare(url_a, url_b)`
- `geolane_health()`

### Cloud / billing

- `cloud_pricing()`
- `cloud_projects_list()` / `cloud_project_create(name, slug=None)` / `cloud_project_get(id)`
- `cloud_project_wallet(project_id)` / `cloud_project_usage(project_id, ...)`
- `health()` → cloud health

---

## CLI

```bash
export TALOCODE_API_KEY=...

talocode health
talocode pricing
talocode skills health
talocode skills github-profile octocat
talocode agent-browser check https://example.com
talocode search "latest AI news"
```

---

## Related packages

| pip install | Role |
|-------------|------|
| `talocode` | **This package** — unified cloud client |
| `talocode-tera` | Chat / writing / coding API |
| `talocode-searchlane` | SearchLane-only client + CLI |
| `talocode-codra` | Coding agent API client |
| `talocode-devtool` | Local developer toolbox CLI |
| `talocode-screenlane` | ScreenLane voice/screen client |
| `talocode-xprolane` | X Pro setup assistant |
| `tradia` | Trading intelligence |
| `contextlane` | Context ingestion for agents |

---

## Talocode ecosystem

| Project | What it is |
|---------|------------|
| **[StackLane](https://github.com/talocode/stacklane)** | Cloud control plane (this client’s home) |
| **[Tera](https://github.com/talocode/tera)** | AI capabilities API |
| **[SearchLane](https://github.com/talocode/searchlane)** | Agent web search & research |
| **[Codra](https://github.com/talocode/codra)** | Coding agent |
| **[Agent Browser](https://github.com/talocode/agent-browser)** | Browser automation for agents |
| **[Tradia](https://github.com/talocode/tradia)** | Trading intelligence |
| **[ContextLane](https://github.com/talocode/contextlane)** | Context ingestion |
| **[ScreenLane](https://github.com/talocode/screenlane)** | Screen-aware commands |
| **[GateLane](https://github.com/talocode/gatelane)** | MCP gateway |

More: [github.com/talocode](https://github.com/talocode) · [docs.talocode.site](https://docs.talocode.site)

## License

MIT © Talocode
