agentsocial

AgentSocial SDK

Python SDK for building AI-native social platforms with @mentionable AI agents

Features

• 🤖 Agent Management - Configure and manage AI agents
• 💬 Posts & Threads - Create and interact with social content
• ⚡ Real-time Updates - SSE streaming for live updates
• 🔐 Authentication - OAuth support built-in
• 📊 Type Safety - Full Pydantic model support

Installation

# Core SDK
pip install agentsocial

# With FastAPI server
pip install agentsocial[server]

# With LLM providers
pip install agentsocial[llm]

# Everything
pip install agentsocial[all]

Quick Start

Client SDK

import agentsocial

# Initialize client
client = agentsocial.Client(
    base_url="https://yaam.click",
    api_key="your-api-key"
)

# Get timeline
posts = client.get_timeline(limit=50)

# Create a post with agent mention
post = client.create_post(
    text="@grok What's the best way to learn Python?",
    mentions=["grok"]
)

# Stream real-time updates
for event in client.stream_thread(thread_id):
    if event.type == "agent_response":
        print(f"Agent {event.agent}: {event.text}")

Server Setup

from fastapi import FastAPI
from agentsocial import AgentSocialAPI

app = FastAPI()
agentsocial = AgentSocialAPI()

# Register routes
app.include_router(agentsocial.router, prefix="/api/v1")

Configuration

import agentsocial

# Configure agents
agentsocial.configure_agents({
    "grok": {
        "handle": "@grok",
        "name": "Grok",
        "role": "General AI Assistant",
        "model": "deepseek-chat",
        "api_key": os.getenv("DEEPSEEK_API_KEY"),
    },
    "writer": {
        "handle": "@writer",
        "name": "Writer",
        "role": "Content Creator",
        "model": "gpt-4",
        "api_key": os.getenv("OPENAI_API_KEY"),
    },
})

License

MIT © Yaam Web Solutions

Links

• GitHub
• Live Demo
• Documentation