docs: update docs to add details and demo
Browse files- README.md +6 -0
- docs/assets/architecture_detailed.svg +1 -1
- docs/assets/architecture_lite.svg +1 -1
- src/app/main.py +46 -2
README.md
CHANGED
|
@@ -32,6 +32,12 @@ Stop worrying about logistics and start exploring! The Backpacking Assistant han
|
|
| 32 |
|
| 33 |
📅 **Complete Itineraries**: Delivers a beautifully formatted, day-by-day plan for your entire trip.
|
| 34 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 35 |
|
| 36 |
## Architecture
|
| 37 |
|
|
|
|
| 32 |
|
| 33 |
📅 **Complete Itineraries**: Delivers a beautifully formatted, day-by-day plan for your entire trip.
|
| 34 |
|
| 35 |
+
For future updates of this application, visit [https://backpacking.life/](https://backpacking.life/) and subscribe
|
| 36 |
+
|
| 37 |
+
|
| 38 |
+
## DEMO VIDEO
|
| 39 |
+
|
| 40 |
+

|
| 41 |
|
| 42 |
## Architecture
|
| 43 |
|
docs/assets/architecture_detailed.svg
CHANGED
|
|
|
|
docs/assets/architecture_lite.svg
CHANGED
|
|
|
|
src/app/main.py
CHANGED
|
@@ -144,8 +144,52 @@ with gr.Blocks(title="Backpacking Assistant") as demo:
|
|
| 144 |
|
| 145 |
with gr.TabItem("Docs", id="docs_tab"):
|
| 146 |
gr.Markdown(
|
| 147 |
-
"""
|
| 148 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 149 |
"""
|
| 150 |
)
|
| 151 |
|
|
|
|
| 144 |
|
| 145 |
with gr.TabItem("Docs", id="docs_tab"):
|
| 146 |
gr.Markdown(
|
| 147 |
+
"""
|
| 148 |
+
For future updates of this application, visit [https://backpacking.life/](https://backpacking.life/) and subscribe
|
| 149 |
+
|
| 150 |
+
|
| 151 |
+
## DEMO VIDEO
|
| 152 |
+
|
| 153 |
+

|
| 154 |
+
|
| 155 |
+
## Architecture
|
| 156 |
+
|
| 157 |
+

|
| 158 |
+
|
| 159 |
+
## FOR DETAILS CHECK [README.md](https://huggingface.co/spaces/MCP-1st-Birthday/backpacking-assistant/blob/main/README.md)
|
| 160 |
+
|
| 161 |
+
## Tech Stack
|
| 162 |
+
|
| 163 |
+
| Layer | Technology |
|
| 164 |
+
|-------|------------|
|
| 165 |
+
| UI and MCP Server | Gradio 6.0+ (hosted on Huggingface) |
|
| 166 |
+
| Agent Framework | OpenAI Agents (`openai-agents` 0.6.1) |
|
| 167 |
+
| AI Platform | Blaxel (LLM access + external MCP tools + agent deployment) |
|
| 168 |
+
| LLM | OpenAI gpt-4o |
|
| 169 |
+
| Package Manager | uv |
|
| 170 |
+
|
| 171 |
+
## The Three-Agent Pipeline
|
| 172 |
+
|
| 173 |
+
The system runs three specialized AI agents **in sequence**:
|
| 174 |
+
|
| 175 |
+
```
|
| 176 |
+
User Request > PlannerAgent > ItineraryAgent > UXAgent > Final Response
|
| 177 |
+
```
|
| 178 |
+
|
| 179 |
+
|
| 180 |
+
## OpenAI ChatGPT App Integration
|
| 181 |
+
|
| 182 |
+
This MCP server is fully compatible with the **OpenAI ChatGPT**. You can connect the MCP server to ChatGPT and use the Flixbus tools directly within conversations.
|
| 183 |
+
|
| 184 |
+
### Rich UI Widgets
|
| 185 |
+
|
| 186 |
+
When used through the ChatGPT app, tools render **interactive visual widgets** instead of raw JSON:
|
| 187 |
+
|
| 188 |
+
| Tool | Widget |
|
| 189 |
+
|------|--------|
|
| 190 |
+
| `get_city_info_tool` | City card with name, country, coordinates, and Flixbus UUID |
|
| 191 |
+
| `search_cities_in_radius_tool` | Grid of city cards showing nearby destinations |
|
| 192 |
+
| `get_tripe_options_list_tool` | Trip options with prices, times, and booking links |
|
| 193 |
"""
|
| 194 |
)
|
| 195 |
|