# ganeshmohank/orbit architecture

> Architecture diagram of the GitHub repository ganeshmohank/orbit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ganeshmohank/orbit
- Repository: https://github.com/ganeshmohank/orbit

## Overview

Orbit’s documented workflow starts with an Omi voice command, batches webhook segments, detects ride requests and locations, then automates an Uber booking and reports status. The repository also documents a Nexus/MCP branch for Jira, Calendar and other productivity tools. Evidence is uneven: the sampled middleware/agent.py implements meeting analysis, not the documented Nexus integrations, and no MCP client appears in the tree. The graph preserves that documented capability but leaves its implementation links unverified.

Main entry points: [`main.py`](https://github.com/ganeshmohank/orbit/blob/main/main.py) (Webhook API), [`uber_automation.py`](https://github.com/ganeshmohank/orbit/blob/main/uber_automation.py) (Ride booking), [`ride_detector.py`](https://github.com/ganeshmohank/orbit/blob/main/ride_detector.py) (Ride detection), [`simple_storage.py`](https://github.com/ganeshmohank/orbit/blob/main/simple_storage.py) (User and session files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Voice entry"]
  node_webhook["Webhook API<br/>[main.py]"]
  node_segment_buffer["Segment batching<br/>[main.py]"]
end

subgraph group_ride["Ride workflow"]
  node_ride_detection["Ride detection<br/>[ride_detector.py]"]
  node_location["Pickup location<br/>[ride_detector.py]"]
  node_booking["Ride booking<br/>[uber_automation.py]"]
  node_browser_pool["Browser pool<br/>[browser_pool.py]"]
end

subgraph group_state["Identity and state"]
  node_auth_api["Auth endpoints<br/>[main.py]"]
  node_auth_manager["Uber authentication<br/>[auth_manager.py]"]
  node_file_storage[("User and session files<br/>[simple_storage.py]")]
end

subgraph group_integrations["Service integrations"]
  node_nexus["Nexus agent<br/>[agent.py]"]
  node_mcp["MCP servers"]
  node_jira["Jira"]
  node_calendar["Calendar"]
  node_other_services["Other services"]
  node_meeting_agent["Meeting analysis<br/>[agent.py]"]
end

node_omi(("Omi device"))
node_user(("User"))
node_uber["Uber"]
node_openai["OpenAI"]

node_user -->|"speaks to"| node_omi
node_omi -->|"sends segments"| node_webhook
node_webhook -->|"batches segments"| node_segment_buffer
node_segment_buffer -->|"detects request"| node_ride_detection
node_ride_detection -->|"asks LLM"| node_openai
node_webhook -->|"resolves pickup"| node_location
node_location -.->|"uses GPS input"| node_ride_detection
node_webhook -->|"starts booking"| node_booking
node_booking -->|"gets browser page"| node_browser_pool
node_booking -->|"loads session, records booking"| node_file_storage
node_browser_pool -->|"automates ride request"| node_uber
node_auth_api -->|"starts login, submits code"| node_auth_manager
node_auth_manager -->|"loads and saves session"| node_file_storage
node_webhook -->|"reads user data"| node_file_storage
node_webhook -->|"returns status"| node_omi
node_user -->|"connects account"| node_auth_api
node_user -->|"requests workflow"| node_nexus
node_nexus -.->|"routes commands"| node_mcp
node_mcp -.->|"integrates"| node_jira
node_mcp -.->|"integrates"| node_calendar
node_mcp -.->|"extends to"| node_other_services
node_meeting_agent -.->|"uses Gemini LLM"| node_openai

click node_webhook "https://github.com/ganeshmohank/orbit/blob/main/main.py"
click node_segment_buffer "https://github.com/ganeshmohank/orbit/blob/main/main.py"
click node_ride_detection "https://github.com/ganeshmohank/orbit/blob/main/ride_detector.py"
click node_location "https://github.com/ganeshmohank/orbit/blob/main/ride_detector.py"
click node_booking "https://github.com/ganeshmohank/orbit/blob/main/uber_automation.py"
click node_browser_pool "https://github.com/ganeshmohank/orbit/blob/main/browser_pool.py"
click node_auth_api "https://github.com/ganeshmohank/orbit/blob/main/main.py"
click node_auth_manager "https://github.com/ganeshmohank/orbit/blob/main/auth_manager.py"
click node_file_storage "https://github.com/ganeshmohank/orbit/blob/main/simple_storage.py"
click node_nexus "https://github.com/ganeshmohank/orbit/blob/main/middleware/agent.py"
click node_meeting_agent "https://github.com/ganeshmohank/orbit/blob/main/middleware/agent.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webhook,node_segment_buffer,node_user toneBlue
class node_ride_detection,node_location,node_booking,node_browser_pool toneAmber
class node_auth_api,node_auth_manager,node_file_storage toneMint
class node_nexus,node_mcp,node_jira,node_calendar,node_other_services,node_meeting_agent toneRose
class node_omi,node_uber,node_openai toneIndigo
```

## Components

### Voice entry

- [Webhook API](https://github.com/ganeshmohank/orbit/blob/main/main.py): `main.py`
- [Segment batching](https://github.com/ganeshmohank/orbit/blob/main/main.py): `main.py`

### Ride workflow

- [Ride detection](https://github.com/ganeshmohank/orbit/blob/main/ride_detector.py): `ride_detector.py`
- [Pickup location](https://github.com/ganeshmohank/orbit/blob/main/ride_detector.py): `ride_detector.py`
- [Ride booking](https://github.com/ganeshmohank/orbit/blob/main/uber_automation.py): `uber_automation.py`
- [Browser pool](https://github.com/ganeshmohank/orbit/blob/main/browser_pool.py): `browser_pool.py`

### Identity and state

- [Auth endpoints](https://github.com/ganeshmohank/orbit/blob/main/main.py): `main.py`
- [Uber authentication](https://github.com/ganeshmohank/orbit/blob/main/auth_manager.py): `auth_manager.py`
- [User and session files](https://github.com/ganeshmohank/orbit/blob/main/simple_storage.py): `simple_storage.py`

### Service integrations

- [Nexus agent](https://github.com/ganeshmohank/orbit/blob/main/middleware/agent.py): `middleware/agent.py`
- **MCP servers**
- **Jira**
- **Calendar**
- **Other services**
- [Meeting analysis](https://github.com/ganeshmohank/orbit/blob/main/middleware/agent.py): `middleware/agent.py`

### Other components

- **Omi device**
- **User**
- **Uber**
- **OpenAI**

## Connections

- User → Omi device: speaks to (evidence: `README.md`)
- Omi device → Webhook API: sends segments (evidence: `README.md`)
- Webhook API → Segment batching: batches segments (evidence: `README.md`)
- Segment batching → Ride detection: detects request (evidence: `main.py`)
- Ride detection → OpenAI: asks LLM (evidence: `ride_detector.py`)
- Webhook API → Pickup location: resolves pickup (evidence: `main.py`)
- Pickup location → Ride detection: uses GPS input (evidence: `ride_detector.py`)
- Webhook API → Ride booking: starts booking (evidence: `main.py`)
- Ride booking → Browser pool: gets browser page (evidence: `uber_automation.py`)
- Ride booking → User and session files: loads session, records booking (evidence: `uber_automation.py`)
- Browser pool → Uber: automates ride request
- Auth endpoints → Uber authentication: starts login, submits code (evidence: `main.py`)
- Uber authentication → User and session files: loads and saves session (evidence: `auth_manager.py`)
- Webhook API → User and session files: reads user data (evidence: `main.py`)
- Webhook API → Omi device: returns status (evidence: `README.md`)
- User → Auth endpoints: connects account (evidence: `README.md`)
- User → Nexus agent: requests workflow (evidence: `README.md`)
- Nexus agent → MCP servers: routes commands (evidence: `README.md`)
- MCP servers → Jira: integrates (evidence: `README.md`)
- MCP servers → Calendar: integrates (evidence: `README.md`)
- MCP servers → Other services: extends to (evidence: `README.md`)
- Meeting analysis → OpenAI: uses Gemini LLM
