https://github.com/friday-platform/agent-sdk-examples
Runnable example agents built with the Friday Agent SDK — copy one as a starting point for your own.
https://github.com/friday-platform/agent-sdk-examples
agent-sdk agents ai-agents automation examples friday friday-platform hubspot llm python
Last synced: 6 days ago
JSON representation
Runnable example agents built with the Friday Agent SDK — copy one as a starting point for your own.
- Host: GitHub
- URL: https://github.com/friday-platform/agent-sdk-examples
- Owner: friday-platform
- License: mit
- Created: 2026-06-08T18:25:51.000Z (26 days ago)
- Default Branch: main
- Last Pushed: 2026-06-08T20:58:52.000Z (26 days ago)
- Last Synced: 2026-06-08T22:25:14.422Z (26 days ago)
- Topics: agent-sdk, agents, ai-agents, automation, examples, friday, friday-platform, hubspot, llm, python
- Language: Python
- Homepage: https://hellofriday.ai/
- Size: 74.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Friday Agent SDK — Examples
[](https://github.com/friday-platform/agent-sdk-examples/actions/workflows/ci.yml)
[](https://www.python.org/downloads/)
[](LICENSE)
> **These examples track the [`friday-agent-sdk`](https://pypi.org/project/friday-agent-sdk/) (alpha) — APIs may change.**
> Pin an exact SDK version when you copy one of these into your own project.
Runnable example agents built with the [Friday Agent SDK](https://github.com/friday-platform/agent-sdk).
Each one is a standalone, registerable agent you can read, run, and copy as the
starting point for your own. The host manages credentials and routes LLM, HTTP,
and MCP calls on the agent's behalf, so your code stays a plain Python function
— no provider SDKs, no key plumbing.
- **SDK reference & guides:** [friday-platform/agent-sdk](https://github.com/friday-platform/agent-sdk)
- **SDK on PyPI:** [`friday-agent-sdk`](https://pypi.org/project/friday-agent-sdk/)
- **Friday platform docs:** https://docs.hellofriday.ai/
- **Friday Studio:** [friday-platform/friday-studio](https://github.com/friday-platform/friday-studio)
## Requirements
The SDK is not standalone — an agent runs inside the Friday host:
- Python 3.12+
- [`uv`](https://docs.astral.sh/uv/) for per-example environments
- A running [Friday Studio](https://github.com/friday-platform/friday-studio)
daemon (provides the host runtime)
- Any credentials an example declares (e.g. `HUBSPOT_ACCESS_TOKEN`), configured
in the daemon's environment — agents never see raw keys directly
## The programming model
A Friday agent is a single Python program. You decorate one handler with
`@agent(...)`, return a result with `ok(...)` / `err(...)`, and call `run()` in
`__main__`. The SDK handles the transport: the host spawns the process per call,
hands your handler the `prompt` and an `AgentContext`, and serializes whatever
you return.
```python
from friday_agent_sdk import AgentContext, agent, err, ok, run
@agent(
id="my-agent",
version="1.0.0",
description="What this agent does.",
environment={"required": [{"name": "SOME_TOKEN", "description": "..."}]},
)
def execute(prompt: str, ctx: AgentContext):
if ctx.http is None:
return err("HTTP capability unavailable")
# ...do work...
return ok({"response": "..."})
if __name__ == "__main__":
run()
```
What the `AgentContext` gives you:
| Field | Use |
| --- | --- |
| `ctx.http` | Outbound HTTP — `ctx.http.fetch(url, method=..., headers=..., body=..., timeout_ms=...)`, raises `HttpError` |
| `ctx.llm` | LLM calls, when an example needs a model in the loop |
| `ctx.stream` | Progress events, e.g. `ctx.stream.intent("Searching…")` |
| `ctx.env` | Resolved values for whatever the decorator declared under `environment` |
| `ctx.input` | Structured input wired from the workspace (e.g. `ctx.input.config`) |
Capabilities (`http`, `llm`, `stream`) can be `None` when not granted, so guard
before use — the examples do.
## Quick start
```bash
cd hubspot-search
uv sync # create .venv from the example's uv.lock
# Register with a local Friday daemon (it then handles one execute call):
curl -X POST http://localhost:8080/api/agents/register \
-H 'Content-Type: application/json' \
-d '{"path": "'"$(pwd)"'/agent.py"}'
```
Each example's own `README.md` documents its input/output contract and any
environment variables it needs.
## Examples
| Example | What it shows |
| --- | --- |
| [`hubspot-search`](hubspot-search) | A **deterministic** agent (no LLM): read config from the prompt, make one authenticated REST call with `ctx.http`, and return a structured result. |
More to come — each new example lands as its own top-level directory.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, how to add a new example, and
the checks CI runs. Quick version:
```bash
uv run ruff check . && uv run ruff format --check . # lint + format (repo root)
cd hubspot-search && uv run pytest # tests (per example)
```
Security issues: see [SECURITY.md](SECURITY.md) — please don't open a public issue.
## License
[MIT](LICENSE)