Siren offers SDKs to help you integrate quickly and efficiently. Currently, SDKs are available for both Python and TypeScript.

​
Requirements

  • A valid Siren API Key (retrievable from your Siren dashboard)

​
Installation

pip install siren-agent-toolkit
For local development:
# From the python/ directory
pip install -e .

​
Quick Start

from siren_agent_toolkit.api import SirenAPI

# Initialize API instance
api = SirenAPI(api_key="YOUR_API_KEY")

# Send a message
result = api.run("send_message", {
	"recipient_value": "user@example.com",
	"channel": "EMAIL",
	"subject": "Important Update",
	"body": "Hello from Siren! This is an important notification."
})
print(result)

​
Sample Integrations

Explore working examples under the examples/ directory:
  • examples/langchain/main.py – Using Siren tools with LangChain
  • examples/openai/main.py – Using Siren tools with OpenAI
  • examples/crewai/main.py – Using Siren tools with CrewAI

​
Configuration Flexibility

api = SirenAPI(
     api_key="YOUR_API_KEY",
     context={"env": "production"}  # Optional environment flag
 )

​
Development & Contribution

​
Local Build

pip install -e .
pip install -r requirements.txt

​
Testing

pytest tests/

​
License

This SDK is released under the MIT License.