Modified "First Agent Template" from HuggingFace Agent Course: Unit 1

Original template from Huggingface Spaces can found here.

The purpose and goal of the modifications:

• To run examples locally instead of on Hugging Face Spaces
• To demonstrate connecting to other models and providers via OpenRouter and test interactions with them
• … and since LiteLLM is used, not only with OpenRouter
• Replace the Gradio web interface with a simple CLI chat.

Setup and run

1. Clone this repo.
2. cd to cloned repo.
3. Copy .env.example to .env and add your API key for OpenRouter.
4. python -m venv .venv
5. source .venv/bin/activate
6. pip install -r requirements.txt

Run the agent: python app.py

Enjoy!