TripMate

TripMate is a multi-agent AI travel assistant system built on decentralized principles that transforms the chaotic process of travel planning into a streamlined, user-centric experience. TripMate leverages modern AI technologies, decentralized storage, and a distributed architecture to provide a comprehensive travel planning solution. This whitepaper details the technical architecture, inter-agent communication protocols, and storage methodologies that power the TripMate ecosystem.

1. Technical Architecture

TripMate implements a distributed microservices architecture consisting of three specialized agents and a decentralized storage layer:

1.1 Core Components

Agent-1 (TripMate Planner): A Node.js-based ElizaOS agent that functions as a conversational interface via Telegram, manages user preferences, trip state, and orchestrates the planning workflow.
Agent-2 (TripMate Finder): A Python-based WebSocket service that processes structured travel queries, interfaces with travel APIs (SERP API, Google Gemini), and returns optimized travel recommendations.
Agent-3 (TripMate Share): An ElizaOS TypeScript agent that enables collaborative trip planning through permissioned access to stored trip data and management of feedback.
Storacha: A decentralized storage network built on Filecoin that provides content-addressed, immutable data storage with cryptographic access controls.

1.2 Technology Stack Architecture

Layer	Component	Technical Implementation
Interface	Telegram Bot API	REST-based messaging interface with webhook support
Application	ElizaOS Framework	JavaScript runtime with agent abstraction, plugin system
Communication	WebSockets	Bidirectional, persistent full-duplex TCP connections
Authentication	DIDs	Decentralized cryptographic identity
Storage	Storacha/IPFS/Filecoin	Content-addressed storage with blockchain-based persistence
Database	SQLite/PostgreSQL	Relational database for conversation state persistence
APIs	SERP API, Google Search	REST-based services for travel data enrichment

2. Agent Architecture & Communication Protocols

2.1 Agent-1 (TripMate Planner) Architecture

Agent-1 operates on the ElizaOS framework, which provides a structured agent runtime environment with:

AgentRuntime: Core execution environment managing the agent lifecycle
Evaluators: Request classification and routing system
Action System: Declarative action registration with handler implementations
Database Adapter: Abstraction layer for database operations
Cache Manager: Optimization layer for conversation context