Zoo Management Platform

A demonstration project that integrates LangChain and FastAPI to control authenticated internal APIs using GenAI tool calling. The project simulates a zoo management platform that can be partially operated through natural language prompts interpreted by an AI agent.

Project Structure

auth0-zoo-ai/
├── api/              # Internal API implementation (FastAPI)
├── agent/            # LangChain application with frontend and backend
├── poetry.lock       # Poetry lock file
├── pyproject.toml    # Poetry project configuration
└── requirements.txt  # Alternative requirements file

Prerequisites

• Python 3.10 or higher
• Poetry (Python dependency management tool)

Installing Poetry

If you don't have Poetry installed, you can install it using one of these methods:

Using pip:

pip install poetry

Using the official installer:

curl -sSL https://install.python-poetry.org | python3 -

On macOS with Homebrew:

brew install poetry

Installation

1. Install dependencies using Poetry:

   poetry install

   This will install all dependencies defined in pyproject.toml and create a virtual environment.

Running the Projects

1. API Server (Port 8000)

The API server provides the internal endpoints for zoo management operations.

Start the API server:

cd api
poetry run uvicorn main:app --host 0.0.0.0 --port 8000 --reload

The API will be available at: http://localhost:8000

2. Agent Application (Port 3000)

The agent application provides the LangChain-based AI interface with a web frontend.

Start the agent application:

cd agent
poetry run python main.py

The agent application will be available at: http://localhost:3000

Development Workflow

1. Start both services:

   • Open a terminal and start the API server (port 8000)
   • Open another terminal and start the agent application (port 3000)

2. Access the applications:

   • API: http://localhost:8000
   • Agent: http://localhost:3000

3. For development with auto-reload:

   • The API server includes --reload flag for automatic restart on code changes
   • The agent application may need manual restart for changes

Environment Variables

Make sure to configure any required environment variables for. Check both .env.sample files to see what is required.