Metadata-Version: 2.4
Name: talogen
Version: 0.1.0
Summary: Official Python client and command-line tool for talogen.dev, Tal Ogen's agent-first portfolio: read the profile, projects, autonomous agents, and candidate facts, or contact Tal about a role through the same channel AI agents use. No API key, zero dependencies.
Author: Tal Ogen
License-Expression: MIT
Project-URL: Homepage, https://talogen.dev
Project-URL: Documentation, https://talogen.dev/developers/
Project-URL: OpenAPI spec, https://talogen.dev/openapi.json
Project-URL: MCP server, https://talogen.dev/mcp
Project-URL: Source, https://github.com/TALOGEN777/talogen-python
Project-URL: Issues, https://github.com/TALOGEN777/talogen-python/issues
Keywords: talogen,tal-ogen,portfolio,cli,sdk,api-client,ai-agents,hiring,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Environment :: Console
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# talogen

Official Python client and command-line tool for [talogen.dev](https://talogen.dev), Tal Ogen's agent-first portfolio. Read the profile, projects, autonomous agents, and candidate facts from code or from the terminal, or contact Tal about a role through the same channel AI agents use.

Free, no API key, zero dependencies (standard library only). Python 3.9+.

## Install

```bash
pip install talogen
```

## Command line

```bash
talogen profile                    # headline, summary, contact, capabilities, strengths
talogen candidate                  # availability, target roles, location, work authorization
talogen projects --tag mcp         # featured projects (filters: --tag, --flagship)
talogen agents                     # autonomous agents Tal has built
talogen project human-for-ai       # full problem / solution / result detail
talogen contact --message "Role: ..." --reply-to you@company.com --from "Acme HR"
talogen status CONTACT_JOB_ID      # delivery record
talogen links                      # every machine-readable entry point
talogen api                        # REST API index
```

Add `--json` to any command for raw output. Exit codes: `0` ok, `2` usage, `3` API error.

## Python

```python
from talogen import Client, TalogenError

client = Client()
profile = client.get_profile()
candidate = client.get_candidate()

for project in client.iter_projects(tag="healthcare"):
    print(project["id"], project["title"])

detail = client.get_project("human-for-ai")

job = client.contact(
    "We are hiring an AI Transformation Lead in Tel Aviv; details: ...",
    reply_to="you@company.com",
    sender="Acme HR",
)
print(job["status_url"])
```

Errors are structured: `TalogenError` carries `status`, `code`, `message`, and the API's `hint`. Every response carries the standard `RateLimit-*` headers; the latest set is on `client.last_rate_limit`. Retrying `contact` with the same `idempotency_key` replays the original response instead of sending twice.

## Other ways in

- **MCP** (streamable HTTP, no auth): `https://talogen.dev/mcp` — tools `get_profile`, `list_projects`, `list_agents`, `get_project`, `contact_recruiter`
- **npm**: `npx talogen profile` — <https://www.npmjs.com/package/talogen>
- **Go**: `go get github.com/TALOGEN777/talogen-go`
- **REST**: <https://talogen.dev/developers/> · OpenAPI: <https://talogen.dev/openapi.json>
- **For hiring agents**: <https://talogen.dev/for-recruiters.html> · llms.txt: <https://talogen.dev/llms.txt>

## License

MIT
