🌟 WYN-Agent-X

WYN-Agent-X is a dynamic and extendable chatbot that integrates with OpenAI and Twilio, allowing you to seamlessly handle user intents and trigger APIs (like sending SMS) based on natural language input. Plus, it’s super friendly and conversational! 🤖💬

Features:

AI-Powered Conversations: Uses OpenAI’s GPT models for general chit-chat. Just type away!
Trigger-Based API Calls: Automatically detects when users want to perform specific tasks (like sending a message), and triggers the corresponding API call.
Easy to Extend: Add more APIs by simply updating the metadata.json file. No need to dig into the core logic! 🌱

🚀 Installation

You can easily install the package via pip:

pip install wyn-agent-x

📂 Directory Structure

wyn-agent-x/
│
├── requirements.txt     # List of dependencies to install
├── wyn_agent_x/
│   ├── __init__.py      # Initializes the package
│   ├── main.py          # Main entry point for the chatbot
│   ├── helper.py        # Helper functions and processing logic
│   ├── list_of_apis.py  # All API functions registered here
│   ├── metadata.json    # Dynamic metadata for API calls and trigger words
│── pyproject.toml       # Optional config if packaging the project
└── README.md            # You're reading this!

System Diagram

The system is designed with an intent processor interpreting the prompt's purpose from the user. After intent processor determines the necessary API required for execution, it attemps to fill up the required input parameters in the input payload. For the unfilled parameters, the resolver bounces the questions back to the user to seek more information before execution. This process interates until all required parameters are filled.

For system diagram, please see here

🎮 Sample Usage

Want to try it out? Just import the AgentX class, provide your API keys, and start chatting with your agent!

from google.colab import userdata

# Fetch API credentials
OPENAI_API_KEY = userdata.get('OPENAI_API_KEY')
TWILIO_ACCOUNT_SID = userdata.get("YOUR_TWILIO_ACCOUNT_SID")
TWILIO_AUTH_TOKEN = userdata.get("YOUR_TWILIO_AUTH_TOKEN")
SERPAPI_API_KEY = userdata.get("SERPAPI_API_KEY")
PY_EMAIL_KEY = userdata.get("PY_EMAIL_KEY")
CLAUDE_API_KEY = os.getenv("CLAUDE_API_KEY")

# Import the agent
from wyn_agent_x.main import AgentX

# Initialize and start the chat!
agent = AgentX(
    api_key=OPENAI_API_KEY,
    account_sid=TWILIO_ACCOUNT_SID,
    auth_token=TWILIO_AUTH_TOKEN,
    serpapi_key=SERPAPI_API_KEY,
    email_key=PY_EMAIL_KEY,
    claude_api_key=CLAUDE_API_KEY,
    protocol='You are a helpful assistant.')
agent.start_chat()

Once started, you'll see this friendly message:

👋 Welcome! Press 'EXIT' to quit the chat at any time.

Feel free to chat with the bot, ask it to send messages, or perform any task you've configured in the metadata. When you're done, simply type EXIT to end the session with a friendly goodbye! 👋

For yfinance demo, please see here

You can also access this notebook.

📖 How it Works

Intent Detection: The agent listens for specific trigger words (like "send a message" or "set a demo") from user input and matches them against the triggers defined in metadata.json.
API Calls: When an intent is detected (e.g., sending an SMS), it calls the corresponding API (like Twilio's SMS API) and logs the event in the event_stream.
Dynamic Functions: Adding a new API or intent is as simple as updating the metadata.json file and registering the new API in list_of_apis.py. No need to modify core logic! 🚀

🛠️ Extend and Customize

You can easily extend WYN-Agent-X by adding new API calls or intents:

Update metadata.json with new API information and trigger words:

{
    "send_email": {
        "trigger_word": ["send email", "notify via email"],
        "sample_payload": {"email": "string", "subject": "string"},
        "prerequisite": null
    }
}

Register your new API in list_of_apis.py with a simple decorator:

@register_function("send_sms")
 def send_sms(payload: Dict[str, str], secrets: Dict[str, str], event_stream: list) -> Dict[str, Any]:
    # Code to send email goes here!
    pass

📜 License

MIT License - Enjoy, use, and extend this project freely! 🥳

👤 Author

Yiqiao Yin

📧 Email: eagle0504@gmail.com

Feel free to reach out if you have any questions, suggestions, or just want to say hi! 😊

Metadata

Release files for wyn-agent-x 0.4.18

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wyn-agent-x 0.4.18
File	Size	Uploaded
wyn_agent_x-0.4.18.tar.gz	20.2 kB	Jan 28, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for wyn-agent-x 0.4.18
File	Interpreter	ABI	Platform	Reset
wyn_agent_x-0.4.18-py3-none-any.whl 19.7 kB Jan 28, 2025	Python 3	none	any	Details

Total release size: 39.9 kB

Release files / wyn_agent_x-0.4.18.tar.gz

Download URL	wyn_agent_x-0.4.18.tar.gz
Size	20.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`65b0298323f998d2ca34d621caeb7b5bad7174c1c5795cb5b3eb3dc0abeb3232`
BLAKE2b-256 checksum How to use checksums	`d9af7246bf80fac2d2b4838ce92a880e1e7a42cff549efd6f638a91581a9ce3c`
Upload date	Jan 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.3 CPython/3.9.13 Windows/10`

Release files / wyn_agent_x-0.4.18-py3-none-any.whl

Download URL	wyn_agent_x-0.4.18-py3-none-any.whl
Size	19.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4d6fc2bf622a0bac54fcbbcdfd80549f00a6a735a210e8b2b535b9ecb08a8bd6`
BLAKE2b-256 checksum How to use checksums	`4353f9a640fd251469a848d196a8e828cdfe810e972001e43d6c2c0410929bbb`
Upload date	Jan 28, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.3 CPython/3.9.13 Windows/10`