Team Ai
Apppublic

AkshayHuggingFace/Travel-Planning-Agent

sourceHugging Faceupdated 11mo agoView on Hugging Face
0likes
App README

Travel Planning Agent

An end-to-end travel concierge powered by Google ADK agents. This Space exposes the existing multi-tool agent stack behind a FastAPI UI served with adk web.

Features

  • —Multi-agent workflow covering flights, hotels, restaurants, weather, transport, and itinerary creation.
  • —Integrates Google Gemini via google-adk for orchestrating tool calls.
  • —Uses SerpApi (google_search_results) for hotel and flight search.
  • —Containerized for reproducible deployment on HuggingFace Spaces.

Local Development

bash
python -m venv venv
venv\Scripts\activate
pip install -r multi_tool_agent/requirements.txt
adk web

Visit http://localhost:8000/dev-ui/ to interact with the agent.

Deployment Notes

  • —Docker image listens on $PORT (default 7860) and runs adk web --host 0.0.0.0.
  • —Secrets such as SERP_API_KEY and Google credentials should be provided via environment variables (HuggingFace Space secrets).
  • —For local Docker testing:
bash
docker build -t travel-agent-space .
docker run -p 7860:7860 --env-file multi_tool_agent/.env travel-agent-space

Open http://localhost:7860/dev-ui/ to verify the UI.

Deploying to HuggingFace Spaces (Beginner Guide)

  1. 1.Create the Space
  2. 2.Sign in at huggingface.co, go to Spaces → New Space, pick a name, leave hardware on CPU, and choose Docker as the runtime.
  3. 3.Generate a token
  4. 4.In Settings → Access Tokens create a write-enabled token; copy it for later (you’ll use it as the Git password).
  5. 5.Connect your repo
  6. 6.From this project folder run git remote add hf https://huggingface.co/spaces/<username>/<space-name> (replace with your Space info).
  7. 7.Push the code
  8. 8.Run git push hf dev:main --force-with-lease and enter your HF username + token when prompted. This triggers the Space build using the included Dockerfile.
  9. 9.Set secrets
  10. 10.In the Space page open Settings → Secrets and add keys like GOOGLE_API_KEY, SERP_API_KEY, and FIRECRAWL_API_KEY. They become environment variables inside the container.
  11. 11.Verify the build
  12. 12.Watch the Build & Logs tab until it shows “Running,” then visit https://huggingface.co/spaces/<username>/<space-name> (the app serves the ADK UI at /dev-ui/).

If you change the app later, repeat steps 4–6 to redeploy.