zerozen 2025.8.9

LLMs in Zen mode

Your hyper-personal, always-on, open-source AI companion.

Dedicated to the creators of Zero — Aryabhatta and Bhaskara ✨

---

Table of Contents

• Installation

• Usage

  • Convert Pydantic Models to XML
  • Chat Interface
  • Gmail Search Tool

• Roadmap

• Contributing

---

Installation

pip install git+https://github.com/aniketmaurya/zerozen.git

---

Usage

Convert Pydantic Models to XML

from zerozen import pydantic_to_xml
from pydantic import BaseModel


class User(BaseModel):
    name: str
    age: int


user = User(name="John", age=30)
xml_string = pydantic_to_xml(user)
print(xml_string)

Output:

<User><name>John</name><age>30</age></User>

---

Chat Interface

zen chat

---

Gmail Search Tool

Now integrated with a Gmail search feature via OpenAI Agents.

Setup

1. Place credentials.json (OAuth credentials) in the project root.
2. Run this tool to set up Gmail search for your agent:

zen setup-gmail

Example usage in Python:

from zerozen import agents

prompt = "Find emails from Stripe with invoices in the last 7 days."

result = agents.run(
    prompt,
    tools=["search_gmail"],
    user_context={"email_user_id": "me"},
)
print(result)

• The agent uses search_gmail to locate matching emails and returns snippets like sender, subject, date, and snippet.
• The search tool works out-of-the-box once authenticated and ready.
• Perfect for building more sophisticated workflows—replying, summarization, reaction automation, and more.

---

Roadmap

Feature	Status
Pydantic-to-XML	✅
CLI Chat Interface	✅
Gmail Integration (search)	✅
Gmail Agent: Read, Draft, Reply	🔳 Planned
“Review & Send” workflow	🔳 Planned
Multi-tool Agents (email, calendar, docs...)	🔳 Planned

---

Contributing

Contributions are welcome! We recommend:

• Opening an issue to suggest features or report bugs
• Submitting pull requests with clear descriptions and tests

---

Enjoy the Zen of zero-friction AI tooling!