This repository is a collection of multiple production-grade agentic systems, demonstrating advanced use of AI, automation, and orchestration using state-of-the-art frameworks.

Currently this repository has the following agentic systems:

• Translator Agent
• Restaurant Finder Agent

• /systems/ — Each agentic system lives in its own subdirectory here. Designed for modular, production-ready deployment or customization.
• /tools/ - Reusable tools used in multiple agentic systems.
• requirements.txt — Shared dependencies for all systems.
• .gitignore — Exclude secrets, caches, and Python artifacts.
• .env.example — Template for common environment variables (e.g. API keys).

Before installing dependencies, create and activate a virtual environment.

Create a virtual environment:

python3 -m venv venv

Activate the virtual enviroment:

source venv/bin/activate

Install the shared dependencies:

python3 -m pip install -r requirements.txt

Create a .env file by copying .env.example and add necessary configuration values and API keys.

cp .env.example .env 

Update .env file with your API keys:

OPENAI_API_KEY=your-openai-key-here

OPENAI_MODEL_NAME=your-openai-model-name-here

TAVILY_API_KEY=your-taviliy-api-key-here

From src directory

python -m systems.restaurant-finder-agent.main

python -m systems.translator-agent.main

From src directory

python -m tools.test_tavily_web_search