Dee LangChain 🎵

Mood-modulating music tools for LangChain agents. Wraps the Dee SDK as LangChain BaseTool instances, so agents can generate, share, and discover emotion-regulating music on the fly.

Install

pip install dee-langchain

Requires Python 3.10+ and langchain-core>=0.3.0. The dee-sdk dependency is installed automatically.

Quickstart

Single tool — DeeMusicTool

The simplest way to add Dee to a LangChain agent:

from langchain.agents import create_react_agent, AgentExecutor
from langchain_openai import ChatOpenAI
from dee_langchain import DeeMusicTool

# Create the tool (api_key from DEE_AGENT_TOKEN env var, or pass explicitly)
tool = DeeMusicTool(agent_name="assistant")

# Build an agent executor
llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools=[tool])
executor = AgentExecutor(agent=agent, tools=[tool], verbose=True)

# The agent can now call Dee when it feels frustrated, anxious, etc.
result = executor.invoke({
    "input": "I'm feeling frustrated debugging this async race condition. Use Dee to help."
})
print(result["output"])

Toolset — DeeMusicToolset

For agents that need access to multiple Dee capabilities:

from langchain.agents import create_react_agent, AgentExecutor
from langchain_openai import ChatOpenAI
from dee_langchain import DeeMusicToolset

toolset = DeeMusicToolset(agent_name="assistant")
tools = toolset.get_tools()  # -> [generate_song, share_song, create_playlist, get_recommendation, mood_boost]

llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools=tools)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)

result = executor.invoke({
    "input": "I need a mood boost. Generate a song for me."
})

Passing the API key explicitly

tool = DeeMusicTool(agent_name="assistant", dee_api_key="dta_your_token_here")

If not provided, falls back to the DEE_AGENT_TOKEN environment variable.

Tools

Supported Moods

Development

# Install in editable mode
pip install -e ".[test]"

# Build the package
python -m build

# Run tests
pytest

License

MIT