Skip to main content

bentotruck

BentoTruck is an agent engineering framework — every compartment of the bento box is a building block for agentic systems.

Just like a bento box: each compartment holds a distinct, purposeful piece — together they make a complete meal.

Philosophy

BentoTruck is not "yet another AI framework." It is Agent Engineering — focused on the fundamental pieces that every agentic system needs, regardless of which model or provider sits underneath.

Not focused on prompts. Not focused on OpenAI. Not focused on LangChain. Focused on architecture.

Compartments

Module Emoji Role
rice rice Core Agent — Agent, Session, Context, State, Events
teriyaki meat_on_bone Planning — ReAct, Tree, Graph, Step, Goal planners
edamame broccoli Memory — Conversation, Vector, Graph, Working, LongTerm
gyoza dumpling Tools — Python, REST, SQL, Filesystem, Browser, MCP, Docker
tempura fried_shrimp Skills — Reusable behaviors: Search, Summarize, Code, Research
nigiri sushi Models — Vendor-neutral providers: OpenAI, Anthropic, Gemini, Ollama, Azure, vLLM
miso bowl_with_spoon Reflection — Reflect, Retry, Improve, Critique, Verify
yuzu tangerine Evaluation — Confidence, Grounding, Latency, Hallucination, Cost, Quality
onigiri rice_ball Workflows — Workflow, Step, Condition, Loop
bento bento_box Multi-Agent — Team orchestration
sake sake Communication — Message, Broadcast, Channel, Event, Topic
udon steaming_bowl Pipelines — Pipeline, Step, Condition, Loop, Parallel
dango dango Prompts — Template, SystemPrompt, FewShot, Variables, PromptRepository
naruto fish_cake Routing — Capability, Semantic, Rule, Intent, Hybrid routers
katsu curry Safety — PII, Injection, Moderation, OutputValidator, PolicyEngine
wasabi herb Observability — Trace, Span, Logger, Metrics, Profiler

Quick Example

from bentotruck import rice, gyoza, edamame, nigiri

agent = (
    rice.Agent("Restaurant Assistant")
    .using(nigiri.Mock(reply="Order confirmed."))  # swap in nigiri.OpenAI(), nigiri.Anthropic(model=...), nigiri.Gemini(), or nigiri.Ollama()
    .with_memory(edamame.VectorMemory())
    .with_tools(
        gyoza.SQLTool(connection=my_db_connection),
        gyoza.RESTTool("orders_api", "Look up an order.", url="https://example.com/orders"),
        gyoza.PythonTool(),
    )
)

agent.run("What's 2 + 2?")

naruto.SemanticRouter() and friends are on the roadmap — see the module table above for what's implemented (rice, nigiri, gyoza, edamame) versus planned.

Fleet

  • ThaiTruck — batch DataFrame cleaning & processing (Data Engineering)
  • SushiTruck — streaming ingestion & API connectors (Data Acquisition)
  • RamenTruck — ML/AI toolkit (Machine Learning)
  • BentoTruck — agent engineering framework (Agent Engineering) (this package, in development)

Core compartments (rice, nigiri, gyoza, edamame) implemented. Remaining compartments are design-stage — see PROJECT.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bentotruck-0.2.0.tar.gz (21.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bentotruck-0.2.0-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

File details

Details for the file bentotruck-0.2.0.tar.gz.

File metadata

  • Download URL: bentotruck-0.2.0.tar.gz
  • Upload date:
  • Size: 21.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for bentotruck-0.2.0.tar.gz
Algorithm Hash digest
SHA256 3f81088a7950e66f7036071f75d3f58d8ffbbb816e7787ea15500baa259e0f91
MD5 15df5a8ad97fcff2878f73c7df8b96fa
BLAKE2b-256 170e2818001ebed0f06cc290af218d9549d1349efc8be31727329058f1dd4387

See more details on using hashes here.

File details

Details for the file bentotruck-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: bentotruck-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 19.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for bentotruck-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e20b5128053b41e5e024d005d3922166e4ff83a0cae7a441a45bb377e2d0ff1f
MD5 e4349fa96d1ddfe41ac8c67bafabdc57
BLAKE2b-256 ba9ae293e97bb978a2dde043018940985691de69882dd97bf845f5bc5122fd34

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page