Trendshift - Ask AI

base on Portia AI offers a Python SDK for building AI agents with flexible options for oversight and authentication. <a href="https://docs.portialabs.ai/steel-thread-intro"> <img alt="SteelThread banner" src="assets/steelthread_banner.png" width="75%"> </a> Our flexible evaluation framework is out! 🧪 Ingest test cases directly from your agent runs rather than building datasets from scratch. 🛰️ Monitor in real-time or with offline evals. 📊 Use custom metric definitions including both deterministic and LLM-based judging. --- <picture> <source media="(prefers-color-scheme: dark)" srcset="assets/Logo_Portia_Line_White.png"> <source media="(prefers-color-scheme: light)" srcset="assets/Logo_Portia_Line_Black.png"> <img alt="Portia AI logo" src="https://raw.githubusercontent.com/portiaAI/portia-sdk-python/main/assets/Logo_Portia_Line_Black.png" width="50%"> </picture> <a href="https://github.com/mahseema/awesome-ai-tools"> <img src="https://awesome.re/mentioned-badge-flat.svg" alt="Mentioned in Awesome"> </a> <a href="https://www.youtube.com/@PortiaAI"> <img src="https://img.shields.io/badge/YouTube-FF0000?logo=youtube&logoColor=white"> </a> <a href="https://discord.gg/DvAJz9ffaR"> <img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white"> </a> <a href="https://x.com/RealPortiaAI"> <img src="https://img.shields.io/badge/ X -000000?logo=twitter&logoColor=white"> </a> <a href="https://www.reddit.com/r/PortiaAI/"> <img src="https://img.shields.io/badge/Reddit-FF4500?logo=reddit&logoColor=white"> </a> <a href="https://www.linkedin.com/company/portiaai"> <img src="https://img.shields.io/badge/LinkedIn-0A66C2?logo=linkedin&logoColor=white"> </a> <a href="https://app.portialabs.ai"> <img src="https://img.shields.io/badge/Dashboard-059669"> </a> <a href="https://docs.portialabs.ai"> <img src="https://img.shields.io/badge/Docs-38BDF8"> </a> <a href="https://blog.portialabs.ai"> <img src="https://img.shields.io/badge/Blog-2D3748"> </a> <a href="https://www.producthunt.com/products/portia-ai?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_source=badge-portia-ai-2" target="_blank"> <img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=983741&theme=light&period=daily&t=1751531459759" alt="Portia AI - Secure AI agents with tools, auth, and smart control | Product Hunt" style="width: 200px; height: 43.2px;" width="200" height="43.2"/> </a> # Portia SDK Python Portia AI is an open source developer framework for predictable, stateful, authenticated agentic workflows. We allow developers to have as much or as little oversight as they’d like over their multi-agent deployments and we are obsessively focused on production readiness. Play around, break things and tell us how you're getting on in our <a href="https://discord.gg/DvAJz9ffaR" target="_blank">**Discord channel (↗)**</a>. Most importantly please be kind to your fellow humans (<a href="https://github.com/portiaAI/portia-sdk-python/blob/main/CODE_OF_CONDUCT.md" target="_blank" rel="noopener noreferrer">**Code of Conduct (↗)**</a>). If you want to dive straight in with an example, dive into one of our examples in our **[Examples Repo (↗)](https://github.com/portiaAI/portia-agent-examples)**. ## Key features **Iterate on agents’ reasoning and intervene in their execution** 🧠 Create your multi-agent [`Plan`](https://docs.portialabs.ai/generate-plan) conversationally, or build them with our [`PlanBuilder`](https://docs.portialabs.ai/generate-plan#build-a-plan-manually). 📝 Enrich a [`PlanRunState`](https://docs.portialabs.ai/run-plan) during execution to track progress. 🚧 Define inputs and output structures for enhanced predictability. ✋🏼 Add deterministic tasks through an [`ExecutionHook`](https://docs.portialabs.ai/execution-hooks). Use a [`clarification`](https://docs.portialabs.ai/understand-clarifications) for human:agent interactions. **Extensive tool support including MCP support** 🔧 Connect [tool registries](https://docs.portialabs.ai/extend-run-tools) from any MCP server, local tools or another AI tool provider (e.g. ACI.dev). 🫆 Leverage Portia cloud's prebuilt [1000+ cloud and MCP tools](https://docs.portialabs.ai/cloud-tool-registry) with out-of-the-box authentication. 🌐 Navigate the web and cope with captchas and logins using our [open source browser tool](https://docs.portialabs.ai/browser-tools). **Authentication for API and web agents** 🔑 Handle user credentials seamlessly, for both API tools and browser sessions, with our `clarification` interface. **Production ready** 👤 Attribute multi-agent runs and auth at an [`EndUser`](https://docs.portialabs.ai/manage-end-users) level. 💾 Large inputs and outputs are automatically stored / retrieved in [Agent memory](https://docs.portialabs.ai/agent-memory) at runtime. 🔗 Connect [any LLM](https://docs.portialabs.ai/manage-config#configure-llm-options) including local ones, and use your own Redis server for [caching](https://docs.portialabs.ai/manage-config#manage-caching). 🌟 Star Portia AI to stay updated on new releases! ## Demo To clickthrough at your own pace, please follow this [link](https://snappify.com/view/3d721d6c-c5ff-4e84-b770-83e93bd1a8f1) ![Feature run-through](https://github.com/user-attachments/assets/1cd66940-ee78-42a6-beb4-7533835de7e9) ## Quickstart ### Installation in 3 quick steps Ensure you have python 3.11 or higher installed using `python --version`. If you need to update your python version please visit their [docs](https://www.python.org/downloads/). Note that the example below uses OpenAI but we support other models as well. For instructions on linking other models, refer to our [docs](https://docs.portialabs.ai/manage-config). **Step 1:** Install the Portia Python SDK ```bash pip install portia-sdk-python ``` **Step 2:** Ensure you have an LLM API key set up ```bash export OPENAI_API_KEY='your-api-key-here' ``` **Step 3:** Validate your installation by submitting a simple maths prompt from the command line ``` portia-cli run "add 1 + 2" ``` **All set? Now let's explore some basic usage of the product 🚀** ### E2E example You will need a Portia API key* for this one because we use one of our cloud tools to schedule a calendar event and send an email. **🙏🏼 *We have a free tier so you do not need to share payment details to get started 🙏🏼.** Head over to <a href="https://app.portialabs.ai" target="_blank">**app.portialabs.ai (↗)**</a> and get your Portia API key. You will then need to set it as the env variable `PORTIA_API_KEY`. The example below introduces **some** of the config options available with Portia AI (check out our <a href="https://docs.portialabs.ai/manage-config" target="_blank">**docs (↗)**</a> for more): - The `storage_class` is set using the `StorageClass.CLOUD` ENUM. So long as your `PORTIA_API_KEY` is set, runs and tool calls will be logged and appear automatically in your Portia dashboard at <a href="https://app.portialabs.ai" target="_blank">**app.portialabs.ai (↗)**</a>. - The `default_log_level` is set using the `LogLevel.DEBUG` ENUM to `DEBUG` so you can get some insight into the sausage factory in your terminal, including plan generation, run states, tool calls and outputs at every step 😅 - To enable ultra-verbose tracing of LLM calls across agents and tools, set `default_log_level=LogLevel.TRACE` (or the string "TRACE"). TRACE includes all DEBUG logs plus additional "LLM call" entries showing the model and high-level purpose (planning, introspection, summarization, parsing/verification, tool-calling). - The `llm_provider` and `xxx_api_key` (varies depending on model provider chosen) are used to choose the specific LLM provider. In the example below we're using GPT 4o, but you can use Anthropic, Gemini, Grok and others! Finally we also introduce the concept of a `tool_registry`, which is a flexible grouping of tools. ```python from dotenv import load_dotenv from portia import Config, Portia, DefaultToolRegistry from portia.cli import CLIExecutionHooks load_dotenv(override=True) recipient_email = input("Please enter the email address of the person you want to schedule a meeting with:\n") task = f""" Please help me accomplish the following tasks: - Get my availability from Google Calendar tomorrow between 8:00 and 8:30 - If I am available, schedule a 30 minute meeting with {recipient_email} at a time that works for me with the title "Portia AI Demo" and a description of the meeting as "Test demo". """ config = Config.from_default() portia = Portia( config=config, tools=DefaultToolRegistry(config=config), execution_hooks=CLIExecutionHooks(), ) plan = portia.run(task) ``` ### Advanced examples on YouTube Here is an example where we build a customer refund agent using Stripe's MCP server. It leverages execution hooks and clarifications to confirm human approval before moving money. [![Customer refund agent with Stripe MCP](assets/stripemcp.jpg)](https://youtu.be/DB-FDEM_7_Y?si=IqVq14eskvLIKmvv) Here is another example where we use our open browser tool. It uses clarifications when it encounters a login page to allow a human to enter their credentials directly into the session and allow it to progress. [![Manage Linkedin connections](assets/linkedinbrowsertool.jpg)](https://youtu.be/hSq8Ww-hagg?si=8oQaXcTcAyrzEQty) ## Learn more - Head over to our docs at <a href="https://docs.portialabs.ai" target="_blank">**docs.portialabs.ai (↗)**</a>. - Join the conversation on our <a href="https://discord.gg/DvAJz9ffaR" target="_blank">**Discord channel (↗)**</a>. - Watch us embarrass ourselves on our <a href="https://www.youtube.com/@PortiaAI" target="_blank">**YouTube channel (↗)**</a>. - Follow us on <a href="https://www.producthunt.com/posts/portia-ai" target="_blank">**Product Hunt (↗)**</a>. ## Paid contributions & contribution guidelines Head on over to our <a href="https://github.com/portiaAI/portia-sdk-python/blob/main/CONTRIBUTING.md" target="_blank">**contribution guide (↗)**</a> for details. Portia offers a **PAID** contribution program by fixing issues on our 'Issues' list. You can read all about this in the <a href="https://github.com/portiaAI/portia-sdk-python/blob/main/CONTRIBUTING.md" target="_blank">**contribution guide (↗)**</a>. # ⭐ Support You can support our work best by leaving a star! ![star](https://github.com/user-attachments/assets/8df5e1d9-a0d4-40b4-9c51-945841744050) We love feedback and suggestions. Please join our <a href="https://discord.gg/DvAJz9ffaR" target="_blank">**Discord channel (↗)**</a> to chat with us. # ❤️ Contributors A heartfelt thank you to our growing list of contributors!  <table> <tbody> <tr> <td align="center"> <a href="https://github.com/fanlinwang"> <img src="https://avatars.githubusercontent.com/u/25503130?v=4" width="100;" alt="fanlinwang"/> fanlinwang </a> </td> <td align="center"> <a href="https://github.com/hannah-portia"> <img src="https://avatars.githubusercontent.com/u/187275200?v=4" width="100;" alt="hannah-portia"/> hannah-portia </a> </td> <td align="center"> <a href="https://github.com/asquare14"> <img src="https://avatars.githubusercontent.com/u/22938709?v=4" width="100;" alt="asquare14"/> Atibhi Agrawal </a> </td> <td align="center"> <a href="https://github.com/judy2k"> <img src="https://avatars.githubusercontent.com/u/359772?v=4" width="100;" alt="judy2k"/> Mark Smith </a> </td> <td align="center"> <a href="https://github.com/md-abid-hussain"> <img src="https://avatars.githubusercontent.com/u/101964499?v=4" width="100;" alt="md-abid-hussain"/> Md Abid Hussain </a> </td> <td align="center"> <a href="https://github.com/saitama142"> <img src="https://avatars.githubusercontent.com/u/53933154?v=4" width="100;" alt="saitama142"/> 0u55 </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/amorriscode"> <img src="https://avatars.githubusercontent.com/u/16005567?v=4" width="100;" alt="amorriscode"/> Anthony Morris </a> </td> <td align="center"> <a href="https://github.com/gaurava05"> <img src="https://avatars.githubusercontent.com/u/45741026?v=4" width="100;" alt="gaurava05"/> Gaurav Agarwal </a> </td> <td align="center"> <a href="https://github.com/jingkaihe"> <img src="https://avatars.githubusercontent.com/u/1335938?v=4" width="100;" alt="jingkaihe"/> Jingkai He </a> </td> <td align="center"> <a href="https://github.com/ksingh-08"> <img src="https://avatars.githubusercontent.com/u/148441103?v=4" width="100;" alt="ksingh-08"/> Karan Singh </a> </td> <td align="center"> <a href="https://github.com/hemanthkotaprolu"> <img src="https://avatars.githubusercontent.com/u/92506047?v=4" width="100;" alt="hemanthkotaprolu"/> Kotaprolu Hemanth </a> </td> <td align="center"> <a href="https://github.com/sangwaboi"> <img src="https://avatars.githubusercontent.com/u/182721678?v=4" width="100;" alt="sangwaboi"/> Vishvendra Sangwan </a> </td> </tr> <tbody> </table>  ", Assign "at most 3 tags" to the expected json: {"id":"14630","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"

AI prompts