Home / Wayfare / Wayfare Specification
Wayfare
Own the Ride. Share the Road.
Wayfare is an open source, owner-first mobility platform designed to connect riders with autonomous vehicles and human-driven transportation providers through a transparent, community-driven ecosystem.
Wayfare enables Tesla owners, robotaxi operators, and verified vehicle owners to participate in a decentralized mobility network while giving riders the ability to choose between autonomous self-driving rides or human drivers. The platform combines ride matching, accurate GPS routing, transparent pricing, AI-powered verification, business analytics, and local discovery into a modular system built for the future of transportation.
Wayfare is designed with a core module architecture that provides essential mobility services while allowing optional plugins to expand capabilities without changing the foundation of the platform.
Project Overview
Wayfare is built around five principles:
- Owner-first mobility — Vehicle owners maintain control over availability, pricing, and earnings.
- Rider choice — Users choose autonomous rides or human-driven transportation.
- Transparency — Open algorithms for pricing, routing, reporting, and platform operations.
- Safety & verification — Identity, vehicle, and driver verification processes protect users.
- Community ownership — Open source development enables collaboration and innovation.
Wayfare transforms ridesharing into a complete mobility ecosystem where transportation, exploration, and vehicle ownership work together.
Core Platform Modules
Wayfare Core
The foundation of the platform providing essential services required for all deployments.
Features
- User account management
- Rider and owner profiles
- Authentication and authorization
- Role-based permissions
- Trip lifecycle management
- Service configuration
- API gateway
- Event communication system
- Platform settings management
Mobility Dispatch Module
Manages ride requests, vehicle matching, and trip coordination.
Features
- Real-time ride request handling
- Autonomous vehicle matching
- Human driver matching
- Vehicle availability tracking
- Intelligent dispatch algorithms
- Trip assignment optimization
- Scheduled ride management
- Multi-stop trip support
- Cancellation and reassignment workflows
Vehicle Management Module
Handles vehicle registration, verification, and operational tracking.
Features
- Vehicle owner registration
- Tesla and EV integration support
- Vehicle profile management
- VIN registration
- Ownership document storage
- Vehicle registration verification
- Vehicle availability settings
- Vehicle service history tracking
- Vehicle condition monitoring
Driver Verification Module
Provides driver onboarding and compliance management.
Features
- Driver profile creation
- Government ID verification
- Driver license verification
- Background verification integrations
- Driver status management
- Driver ratings and reviews
- Compliance tracking
AI Vehicle Inspection Module
Uses AI-assisted analysis to verify vehicle quality.
Features
- Vehicle photo submission
- Exterior inspection:
- Front
- Rear
- Left side
- Right side
- Roof
- Interior inspection:
- Seats
- Dashboard
- Passenger area
- Cargo area
- Condition scoring
- Damage detection
- Maintenance recommendations
- Inspection history
GPS & Routing Module
Provides accurate location tracking and navigation.
Features
- Real-time GPS tracking
- Route calculation
- Distance measurement
- Time estimation
- Traffic-aware routing
- Map matching
- Geofencing
- Trip history
- Location analytics
Supported technologies:
- OpenStreetMap
- OSRM
- Valhalla
- PostGIS
Pricing & Earnings Module
Provides transparent fare calculations and owner payments.
Features
- Distance-based pricing
- Time-based pricing
- Dynamic pricing options
- Owner-controlled pricing rules
- Platform fee transparency
- Earnings calculations
- Payment tracking
- Revenue reports
- Digital ledger system
Scheduling Module
Allows riders to request transportation in advance.
Features
- Future ride scheduling
- Availability forecasting
- Driver notifications
- Autonomous vehicle scheduling
- Calendar integration
- Reminder notifications
- Demand prediction
AI Analytics Module
Provides intelligence for riders, owners, and operators.
Features
- Business mileage reports
- Earnings analysis
- Trip summaries
- Vehicle utilization reports
- Demand forecasting
- Route efficiency analysis
- Fraud detection
- Operational insights
Business Mileage Reporting Module
Provides tax and business-use reporting.
Features
- Automatic trip logging
- Business mileage calculations
- Date-based reports
- Vehicle mileage summaries
- Earnings per mile analysis
- PDF exports
- CSV exports
- Accounting integrations
Local Discovery Module
Transforms transportation into exploration.
Features
- Nearby attractions
- Parks and recreation
- Landmarks
- Museums
- Events
- Restaurants
- Budget-friendly recommendations
- Lowest-price discovery
- Route-based suggestions
- Tourist recommendations
Safety & Trust Module
Improves rider and driver confidence.
Features
- Emergency assistance
- Trusted contact sharing
- Ride tracking
- Safety alerts
- Driver ratings
- Rider ratings
- AI moderation
- Incident reporting
Payments Module
Handles financial transactions.
Features
- Rider payments
- Owner payouts
- Driver compensation
- Transaction history
- Refund processing
- Digital receipts
- Financial reporting
Optional Plugin Modules
The following modules extend Wayfare without modifying the core platform.
Autonomous Fleet Plugin
Adds advanced autonomous vehicle management.
Features
- Robotaxi fleet management
- Autonomous vehicle monitoring
- Remote fleet dashboards
- Sensor integrations
- Autonomous availability prediction
Tesla Integration Plugin
Provides Tesla-specific functionality.
Features
- Tesla vehicle telemetry
- Battery monitoring
- Charging status
- Vehicle location
- Vehicle availability synchronization
EV Charging Plugin
Adds electric vehicle infrastructure support.
Features
- Charging station discovery
- Charging availability
- Route planning with charging stops
- Charging cost estimates
- Energy usage tracking
Delivery Services Plugin
Expands Wayfare into logistics.
Features
- Package delivery
- Food delivery
- Local courier services
- Delivery routing
- Delivery scheduling
Fleet Operator Plugin
Supports commercial operators.
Features
- Multi-vehicle management
- Employee driver accounts
- Fleet analytics
- Maintenance tracking
- Revenue management
Rewards & Loyalty Plugin
Adds community incentives.
Features
- Rider rewards
- Owner incentives
- Loyalty points
- Referral programs
- Community rewards
Carbon Tracking Plugin
Adds environmental reporting.
Features
- Carbon savings estimates
- EV impact tracking
- Sustainability reports
- Green ride badges
Community Governance Plugin
Supports decentralized decision-making.
Features
- Community proposals
- Feature voting
- Local mobility councils
- Platform transparency reports
Technology Stack
Backend
- Node.js / Fastify
- Python / FastAPI
Database
- PostgreSQL
- PostGIS
Messaging
- WebSockets
- MQTT
- Redis Streams
- NATS
Mobile Applications
- React Native
- Flutter
Maps
- OpenStreetMap
- MapLibre
- OSRM
- Valhalla
AI Systems
- Computer vision models
- Machine learning analytics
- Predictive optimization models
Deployment
- Docker
- Kubernetes
- Cloud or self-hosted environments
Future Roadmap
Future development areas include:
- Advanced autonomous fleet support
- Smart city transportation integration
- Public transit partnerships
- Vehicle-to-grid energy integration
- AI travel planning assistants
- Autonomous delivery networks
- Community-owned mobility cooperatives
Wayfare
Own the ride. Share the road.
Specification Branding License (SBL)
Standard
- Fully AGPL-3.0+ compliant system
- Copyleft enforced for network deployments
- Required attribution:
- Roxanne Ardary
- https://www.roxanneardary.com/
Optional
- Specification Branding License (SBL)
- Attribution-free commercial deployment
- Pricing based on scale, usage, and deployment scope
- https://roxanneardary.com/wayfare/
License & Notice Requirements
Wayfare is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to this project, you agree that your contributions will also be released under this license.
Please note the following:
- All contributions must comply with the AGPL-3.0+ terms.
- Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
Roxanne Ardary and roxanneardary.com. - Wayfare specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
- The project’s
notice.mdfile tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also updatenotice.md. - When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
- Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.
For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.
Notice – Wayfare
Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.
Contributors
This file tracks contributors and their specific contributions to the project.
- Roxanne Ardary, roxanneardary.com – March 11, 2026
Created the repository for Wayfare. Designed the open-source robotaxi platform with autonomous and human-driven ride options, AI verification, real-time GPS tracking, and local discovery features. - [Add other contributors here] – [Date]
[Describe contribution in one sentence]
License – Wayfare
This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
Key Points:
- You are free to use, modify, and distribute the code.
- All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
- The software is provided “as is,” without warranty of any kind.
For the full license text, see GNU AGPL-3.0 License.