3 releases (breaking)

0.9.0 Oct 7, 2025
0.8.0 Sep 15, 2025
0.7.0 Sep 13, 2025

#1587 in Machine learning

Download history 21/week @ 2025-09-07 854/week @ 2025-09-14 260/week @ 2025-09-21 269/week @ 2025-09-28 408/week @ 2025-10-05 198/week @ 2025-10-12 426/week @ 2025-10-19 232/week @ 2025-10-26 9/week @ 2025-11-02

884 downloads per month
Used in 13 crates (4 directly)

MIT license

245KB
6K SLoC

Potato Head

Potato Head is a core/utility crate to both opsml and scouter, providing essential rust and python components for building agentic workflows. At the current moment, only crates are published, which are then used in both opsml and scouter to provide user-friendly interfaces. The documentation contained in this repository is meant to help you understand the core concepts of potatohead and how to use it within Opsml and Scouter.

Creating a Talking Potato

To get your potato to talk, you first need to create a Prompt. It's gotta have something to say, right?

from potato_head import Prompt

prompt = Prompt(
  model="gpt-4o",
  provider="openai",
  message="Tell me a joke about potatoes.",
  system_instruction="You are a helpful assistant.",
)

How do we make the potato talk?

from potato_head import Agent, Provider

agent = Agent(Provider.OpenAI)
response = agent.execute_prompt(prompt=prompt)


print(response.result)
# Why did the potato win the talent show?
# Because it was outstanding in its field!

Documentation

For more information, please refer to the documentation.

Dependencies

~14–32MB
~456K SLoC