shopagent-core

Core LangGraph agent, RAG pipeline, and store-data tools for ShopAgent-OS — a self-hosted e-commerce AI agent. Import this into your own Python backend if you already have one and just want the agent logic, rather than running ShopAgent-OS's own prebuilt FastAPI server.

If you don't have an existing backend, it's usually simpler to deploy the full backend/ app from the repo as-is (see the main repo README) instead of wiring this library in by hand.

Install

pip install shopagent-core

Optional extras:

pip install "shopagent-core[langfuse]"   # tracing/observability
pip install "shopagent-core[shopify]"    # Shopify Admin API store adapter

Configuration

Reads these environment variables (e.g. via a .env file with python-dotenv, which this package already depends on):

Usage

from shopagent_core.agent.graph import run_agent

reply = run_agent(
    user_message="What shoes do you have in stock?",
    session_id="some-session-id",       # optional: keeps conversation history in memory
    customer_email="jane@example.com",  # optional: enables automatic order-ownership verification
)
print(reply)

run_agent is synchronous and returns a plain string reply. It's up to your own backend to wrap this in a route, handle authentication, and apply rate limiting — this package only provides the agent itself, not a server.

License

MIT