PyAgentix 0.1.2

PyAgentix is a lightweight Python library that enables quick and easy creation of model-agnostic AI agents.

PyAgentix

PyAgentix is a Python framework to build AI agents and chatbots using large language models (LLMs). It supports agents, groups of agents, synchronous and asynchronous calls, JSON and text responses, and includes a basic CLI chatbot.

---

Installation

pip install pyagentix

Note: This package requires Python 3.8+.

---

Features

• Agent and AgentGroup abstractions
• Synchronous and asynchronous support
• JSON and text response formats
• CLI chatbot with file upload support

---

Quick Start

1. Create and use a text response agent

from pyagentix.agent import AgentUnit

agent = AgentUnit(
    instruction="You are a helpful assistant."
)
agent.llm.provider = "openai"

response = agent.work("Who is the first person walking on the Moon?")
print("Text response:", response.content)

---

2. Create and use a JSON response agent

from pyagentix.agent import AgentUnit

json_agent = AgentUnit(
    instruction=(
        "You are a helpful assistant. Always respond with a JSON object "
        "with exactly two keys: 'first_name' and 'last_name'."
    ),
    response_format="json_object"
)
json_agent.llm.provider = "openai"

json_response = json_agent.work("Who is the first person walking on the Moon?")
print("JSON response:", json_response.data)

---

3. Use the agent asynchronously

import asyncio

query = "Who is the first person walking on the Moon?"
text_response = asyncio.run(agent.work_async(query))
print("Async text response:", text_response.content)

---

4. Run the CLI chatbot

from pyagentix.agent import AgentUnit
from pyagentix.chatbot import Chatbot

agent = AgentUnit(
    instruction="You are a helpful assistant."
)
agent.llm.provider = "openai"

chatbot = Chatbot(client=agent)
chatbot.cli_run()

---

Configuration

PyAgentix reads API keys from environment variables by default:

• OPENAI_API_KEY
• GROQ_API_KEY
• GEMINI_API_KEY
• PERPLEXITY_API_KEY

You can also set API keys and providers programmatically on the agent's LLM instance.

---

Contributing

Contributions are welcome. Please open issues or pull requests on GitHub.

---

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

If you have questions or need help, feel free to open an issue or contact the maintainer.