From 59f51c8bda0882449575a319e4a0da08e8a30196 Mon Sep 17 00:00:00 2001 From: Robert Gambee Date: Tue, 20 Jan 2026 08:45:48 -0800 Subject: [PATCH 1/4] Fix README example for single_agent --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index cdd8ea0b..06f7d8ec 100644 --- a/README.md +++ b/README.md @@ -170,11 +170,15 @@ Web research on single inputs or entire dataframes. Agents are tuned on [Deep Re ```python from everyrow.ops import single_agent, agent_map from pandas import DataFrame +from pydantic import BaseModel + +class CompanyInput(BaseModel): + company: str # Single input result = await single_agent( task="Find this company's latest funding round and lead investors", - input={"company": "Anthropic"}, + input=CompanyInput(company="Anthropic"), ) # Batch From d5355cecd6b99cdae233f4e69d5715ccf01ef6f9 Mon Sep 17 00:00:00 2001 From: Robert Gambee Date: Tue, 20 Jan 2026 08:45:58 -0800 Subject: [PATCH 2/4] Point to AGENT.md for more info --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 06f7d8ec..62b78535 100644 --- a/README.md +++ b/README.md @@ -196,6 +196,8 @@ result = await agent_map( --- +[Full documentation →](docs/AGENT.md) + ## Advanced ### Sessions From d74966db96d9ad74a8c20b8aa05bd627c0529ac7 Mon Sep 17 00:00:00 2001 From: Robert Gambee Date: Tue, 20 Jan 2026 08:54:40 -0800 Subject: [PATCH 3/4] Add section for derive to the README --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index 62b78535..c3fc2b2d 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,7 @@ Regex can't do this. `"remote" in text` matches "No remote work available." `"$" | [**Dedupe**](#dedupe) | Deduplicate when fuzzy matching fails | | [**Merge**](#merge) | Join tables when keys don't match | | [**Agent Tasks**](#agent-tasks) | Web research on every row | +| [**Derive**](#derive) | Add computed columns | --- @@ -198,6 +199,25 @@ result = await agent_map( [Full documentation →](docs/AGENT.md) +### Derive + +Add computed columns using [`pandas.DataFrame.eval`](https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.eval.html#pandas.DataFrame.eval), no AI agents needed. + +```python +from everyrow.ops import derive + +result = await derive( + input=orders_dataframe, + expressions={"total": "price * quantity"}, +) +``` + +`derive` is useful for adding simple calculated fields before or after other operations. It's much faster and cheaper than using AI agents to do the computation. + +**Examples** +- Simple usage example: [derive_example.py](examples/derive_example.py) + + ## Advanced ### Sessions From 70d4b3beeaafea65cdbe05db6f24320279cf2b79 Mon Sep 17 00:00:00 2001 From: Robert Gambee Date: Tue, 20 Jan 2026 14:23:20 -0800 Subject: [PATCH 4/4] Make links for Agent and Dervice match other ops --- README.md | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index c3fc2b2d..382d82a8 100644 --- a/README.md +++ b/README.md @@ -193,11 +193,7 @@ result = await agent_map( ) ``` -**Examples:** [single_agent](examples/single_agent_example.py) / [agent_map](examples/agent_map_example.py) - ---- - -[Full documentation →](docs/AGENT.md) +**More:** [docs](docs/AGENT.md) / [single_agent example](examples/single_agent_example.py) / [agent_map example](examples/agent_map_example.py) ### Derive @@ -214,8 +210,7 @@ result = await derive( `derive` is useful for adding simple calculated fields before or after other operations. It's much faster and cheaper than using AI agents to do the computation. -**Examples** -- Simple usage example: [derive_example.py](examples/derive_example.py) +**More:** [example](examples/derive_example.py) ## Advanced