Document HuggingFace deployment steps

README.md

@@ -42,3 +42,20 @@ 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. **Create the Space**
+	- Sign in at [huggingface.co](https://huggingface.co), go to *Spaces → New Space*, pick a name, leave hardware on CPU, and choose **Docker** as the runtime.
+2. **Generate a token**
+	- In *Settings → Access Tokens* create a write-enabled token; copy it for later (you’ll use it as the Git password).
+3. **Connect your repo**
+	- From this project folder run `git remote add hf https://huggingface.co/spaces/<username>/<space-name>` (replace with your Space info).
+4. **Push the code**
+	- 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`.
+5. **Set secrets**
+	- 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.
+6. **Verify the build**
+	- 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.