Building Basic Location-Aware Agents with Gaia Nodes

pip install deepagents tavily-python python-dotenv langchain-openai

GAIANET_API_KEY=your_gaia_api_key
GAIANET_BASE_URL=your_gaia_node_url
TAVILY_API_KEY=your_tavily_api_key

def create_gaia_client():
    return ChatOpenAI(
        api_key=os.environ.get("GAIANET_API_KEY"),
        model="Qwen3-4B-Q5_K_M",
        base_url=os.environ.get("GAIANET_BASE_URL"),
        temperature=0.1
    )

def location_search(query: str, max_results: int = 10):
    """Natural language location search using local AI"""
    gaia_client = create_gaia_client()
    response = gaia_client.invoke(f"LOCATION_SEARCH:{query}:{max_results}")
    return response.content

def internet_search(query: str, max_results: int = 5):
    """Complement location data with real-time web information"""
    try:
        result = tavily_client.search(query, max_results=max_results)
        return str(result)
    except Exception as e:
        return f"Web search error: {str(e)}"

query = "What are the best coffee shops in Paris?"

query = "Coffee shops near tourist attractions in Paris"

query = "Find family-friendly restaurants near Golden Gate Bridge"

🔍 Query: What are the best coffee shops in Paris?
==================================================
Response: **Summary**:  
Paris is renowned for its charming cafes and coffee shops, which often serve as cultural hubs. These establishments range from historic patisseries to modern, minimalist spots. The best coffee shops in Paris offer a unique blend of French tradition, artisanal coffee, and cozy atmospheres.

---

### **Top Recommendations**

1. **Le Comptoir de la Gastronomie**  
   - **Address**: 37 Rue Duvaleur, 75001 Paris  
   - **Details**: A beloved spot in the Montmartre district, this café is famous for its warm ambiance and traditional French coffee. It has been a favorite among locals and visitors for decades. The menu includes classic items like croissants and pastries, alongside a selection of coffees.  
   - **Citations**: Gaia location_search + internet_search (Google Reviews)

2. **Café de l’Escargot**  
   - **Address**: 43 Rue du Faubourg Saint-Honoré, 75001 Paris  
   - **Details**: A historic café in the heart of Paris, known for its elegant decor and excellent coffee. It also serves a variety of French pastries and light meals. The atmosphere is both refined and welcoming.  
   - **Citations**: Gaia location_search + internet_search (Google Reviews)

3. **La Maison de la Café**  
   - **Address**: 112 Rue de Rivoli, 75001 Paris  
   - **Details**: This modern café combines French charm with contemporary coffee-making techniques. It offers a range of specialty coffees and has an open kitchen where you can watch the baristas craft your drink. The ambiance is relaxed and inviting.  
   - **Citations**: Gaia location_search + internet_search (Google Reviews)

4. **Café de l’Espresso**  
   - **Address**: 73 Rue du Faubourg Saint-Honoré, 75001 Paris  
   - **Details**: A stylish spot that focuses on high-quality espresso and cappuccinos. It has a minimalist design and is popular among both locals and tourists. The menu also includes a variety of pastries and light snacks.  
   - **Citations**: Gaia location_search + internet_search (Google Reviews)

5. **Le Patisserie du Soleil**  
   - **Address**: 20 Rue de Douai, 75001 Paris  
   - **Details**: While primarily a patisserie, this shop also serves excellent coffee and pastries. It is known for its beautiful decor and the quality of its baked goods. The café has a cozy, family-friendly atmosphere.  
   - **Citations**: Gaia location_search + internet_search (Google Reviews)

---

### **Insights**  
- Many of the top coffee shops in Paris are located in historic or culturally significant areas, such as Montmartre and the Champs-Élysées.  
- These cafes often serve as meeting places for locals and tourists alike, blending traditional French culture with modern comforts.  
- The quality of coffee and pastries is a key factor in choosing these spots, with many emphasizing artisanal ingredients and skilled baristas.

---

### **Practical Tips**  
- **Opening Hours**: Most cafes in Paris are open from 7:00 AM to 8:00 PM, though some may have slightly different hours.  
- **Reservations**: While not always required, it is advisable to make a reservation at popular spots during peak hours (e.g., weekends or holidays).  
- **Pricing**: A coffee typically ranges from €3 to €6, while pastries can range from €2 to €5 depending on the item.  
- **Transportation**: Many of these cafes are accessible via the metro and bus system. Use the journey_planning tool to find the best routes to each location.

---

**Todos Completed**:  
- Used Gaia location_search to find top coffee shops in Paris.  
- Conducted internet_search for additional details, reviews, and context on each cafe.  
- Synthesized findings into a structured response with actionable insights.  
- Provided recommendations based on quality, ambiance, and cultural significance.