# Meet Tvara v1: Build Agents and Workflows Without the Hassle

## Introduction

We’re excited to announce the launch of **Tvara SDK v1 on PyPI** 🎉 – your open-source toolkit to build **agents and workflows** without getting locked into a single vendor.

Whether you’re a **student developer hacking at night**, a **corporate dev shipping fast**, or an **enterprise team scaling automation**, Tvara gives you a clean, extensible way to connect models, tools, and workflows.

%[https://youtu.be/kqg5lR47zH8] 

## Why Tvara?

We’ve watched too many devs, from students to enterprises, burn hours fighting with agent frameworks.

* LangChain? Bloated boilerplate.
    
* LangGraph? Endless nodes and wiring diagrams.
    

All you wanted was an agent that *just works*.

**Tvara flips that.**

* **Multi-LLM freedom** → OpenAI, Claude, Gemini, whatever you prefer.
    
* **Plug-and-play connectors** → Gmail, Notion, GitHub, Salesforce, and more.
    
* **Agents + Workflows out of the box** → No over-engineering, no 50 lines of setup.
    
* **Truly open-source** → No vendor lock-in, no walls around your ideas.
    

> Stop configuring graphs. Start building agents.

## Who’s It For?

### Students & Indie Devs

* Example 1: Build a **personal study assistant** that fetches lecture notes from Notion and emails you a summary every morning.
    
* Example 2: Create a **mini research agent** that scrapes GitHub issues + academic APIs, then formats insights into a doc automatically.
    

> No more long boilerplates. Just mention your tools and you’re good to go.

### Corporate Devs

* Example 1: Automate **meeting scheduling**: an agent that parses incoming meeting requests (emails), checks calendar availability, and suggests a slot back.
    
* Example 2: Build a **CI/CD agent** that comments on PRs by analyzing test results + code style.
    

> Useful side-projects that save hours while making you look like the “AI guy” on the team.

### Enterprises

* Example 1: **Supervised workflow** for lead intake — gather details from multiple sources (Salesforce + Slack + email), then auto-log into CRM.
    
* Example 2: **Multi-step workflow** that routes support tickets based on priority, fetches relevant docs, and escalates high-severity ones to Slack.
    

> Secure, flexible, and works with your stack.

## One Agent. One Workflow. Example

### Agent Example

**A Notion agent to fetch your data**

```python
from tvara.core import Agent

agent = Agent(
    name="My Notion Agent",
    model="gemini-2.5-flash", 
    api_key="your_model_api_key",
    composio_api_key="your_composio_api_key",
    composio_toolkits=["notion"],
)

response = agent.run("hey hi there. can you summarize 'Pondicherry - 2025' page for me?")
```

### Workflow Example

**A weather, poet and Gmail agent who takes the latest weather, creates a poem on it and emails it to users.**

```python
from tvara.core import Agent, Workflow, Prompt

weather_agent = Agent(
    name="Weather Agent",
    model="gemini-2.5-flash",
    api_key="your_model_api_key",
    composio_api_key="your_composio_api_key",
    composio_toolkits=["WEATHERMAP"],
)

poet_agent = Agent(
    name="Poet Agent",
    model="gemini-2.5-flash",
    api_key="your_model_api_key",
)

gmail_agent = Agent(
    name="Gmail Agent",
    model="gemini-2.5-flash",
    api_key="your_model_api_key",
    composio_api_key="your_composio_api_key",
    composio_toolkits=["gmail"]
)

manager_agent = Agent(
    name="Manager Agent",
    model="gemini-2.5-flash",
    api_key="your_model_api_key",
    prompt=Prompt(
        raw_prompt="You are a workflow manager coordinating multiple AI agents. Your job is to decide what should happen next."
    )
)

my_workflow = Workflow(
    name= "Sample Workflow",
    agents=[weather_agent, poet_agent, gmail_agent],
    mode= "supervised",
    manager_agent=manager_agent,
)

response = my_workflow.run("get the latest weather of sanfrancisco, write about it in a poetic way and send it to team@tvarahq.com on Gmail").final_output
```

## Why v1 Matters

This is just the start. Tvara v1 brings a foundation: agents, workflows, connectors, multi-LLM. From here, we’re building towards **truly reactive, supervised, deployable workflows!**

## Get Started

* [PyPI](https://pypi.org/project/tvara/)
    
* [GitHub](https://github.com/tvarahq/tvara)
    

```bash
pip install tvara
```

We can’t wait to see what you’ll build. Tag us with your projects!

## Contribute

Tvara is open-source, built with love, and we’d love for you to be part of its journey!  
Whether you’re a seasoned developer or making your **first ever open-source contribution**, Tvara is a safe and welcoming space to learn, build, break, and improve together.

Here’s how you can start:

* **Star the repo** to show your support (it really helps us grow!)
    
* Spot a bug? Open an issue.
    
* Got an idea? Share it or send a PR.
    
* Improve our docs or add examples (every little bit counts!)
    

Remember, every contribution, no matter how small, makes Tvara better. You’re not just contributing code, you’re helping shape a tool that can impact how agents and workflows are built worldwide.

So jump in, experiment, and let’s build something amazing together!  
Check out our [CONTRIBUTING.md](https://github.com/tvarahq/tvara/blob/main/CONTRIBUTING.md) to get started.