Skip to main content

Saptiva-Agents es un potente framework para construir aplicaciones de IA multiagente que pueden actuar de forma autónoma o colaborar con humanos.

Project description

🤖 Saptiva Agents

Python PyPI version License Documentation

Saptiva-Agents is a powerful framework for building multi-agent AI applications that can act autonomously or collaborate with humans.


⚙️ Installation

Saptiva-Agents requires Python 3.10 or later. To install from PyPI:

pip install -U saptiva-agents

🚀 Quickstart

👋 Hello World

Create an assistant agent using llama3.3:70b with Saptiva-Agents:

import asyncio

from saptiva_agents import LLAMA_MODEL
from saptiva_agents.base import SaptivaAIChatCompletionClient
from saptiva_agents.agents import AssistantAgent

async def main() -> None:
    model_client = SaptivaAIChatCompletionClient(
        model=LLAMA_MODEL, 
        api_key="YOUR_SAPTIVA_API_KEY"
    )
    agent = AssistantAgent("assistant", model_client=model_client)
    print(await agent.run(task="Say 'Hello World!'"))
    await model_client.close()

asyncio.run(main())
python hello_world.py

🌐 Web Browsing Agent Team

Create a browser-based agent team using Playwright:

# pip install saptiva-agents
# playwright install --with-deps chromium

import asyncio

from saptiva_agents import QWEN_MODEL
from saptiva_agents.agents import UserProxyAgent
from saptiva_agents.base import SaptivaAIChatCompletionClient
from saptiva_agents.conditions import TextMentionTermination
from saptiva_agents.teams import RoundRobinGroupChat
from saptiva_agents.web_surfer import MultimodalWebSurfer
from saptiva_agents.ui import Console

async def main() -> None:
    model_client = SaptivaAIChatCompletionClient(
        model=QWEN_MODEL, 
        api_key="YOUR_SAPTIVA_API_KEY"
    )
    web_surfer = MultimodalWebSurfer(
        "web_surfer", 
        model_client, 
        headless=False, 
        animate_actions=True, 
        start_page="https://www.google.com"
    )
    user_proxy = UserProxyAgent("user_proxy")
    termination = TextMentionTermination("exit", sources=["user_proxy"])
    team = RoundRobinGroupChat([web_surfer, user_proxy], termination_condition=termination)

    try:
        await Console(team.run_stream(task="Navega a saptiva.com y consigue información sobre Saptiva AI."))
    finally:
        await web_surfer.close()
        await model_client.close()

asyncio.run(main())
python web_surfer.py

📚 Available Models

Saptiva-Agents supports a variety of models for both text and multimodal tasks.

🧠 Text Models

Model Description
llama3.3:70b State-of-the-art model based on Meta LLaMA 3, ideal for complex natural language tasks.
qwen2.5:72b-instruct Advanced instruction-tuned model from Alibaba DAMO, designed to follow user prompts precisely.

🖼️ Multimodal Models

Model Description
gemma3:27b Multimodal model capable of reasoning over visual and textual inputs. Ideal for interactive tasks and web exploration.

🔗 View the full list of available Saptiva models


📄 License

This project is licensed under the MIT License.


🌐 Links

Project details


Download files

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

Source Distribution

saptiva_agents-0.1.5.tar.gz (38.3 kB view details)

Uploaded Source

Built Distribution

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

saptiva_agents-0.1.5-py3-none-any.whl (53.7 kB view details)

Uploaded Python 3

File details

Details for the file saptiva_agents-0.1.5.tar.gz.

File metadata

  • Download URL: saptiva_agents-0.1.5.tar.gz
  • Upload date:
  • Size: 38.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for saptiva_agents-0.1.5.tar.gz
Algorithm Hash digest
SHA256 49eb5ed4d69842f385e35cb9987d62e2d58b1bdff6bbd4d7299405a405cb9f5a
MD5 158c28a0cc0c3f17a46e91e541a0202d
BLAKE2b-256 fdac26f99806a302fccba275cba3286115195b1227363b722f2aadc245b5e260

See more details on using hashes here.

File details

Details for the file saptiva_agents-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: saptiva_agents-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 53.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for saptiva_agents-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 1ea3523dfed76d9f887634377185febcd856516a4ffc516b0829bbd26a621806
MD5 5826317cbae6f008c441c2c82bd6cb94
BLAKE2b-256 9e7322e8ded5cf7d250ba82b07e97ae4f4fac9e4045ea2fc04d001d03d10c3c5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page