Skip to content

MeatyAri/inteliport

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

34 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

InteliPort - Intelligent University Transportation System

A revolutionary transportation planning system that introduces UII (User Intent Interface) - a new paradigm for human-computer interaction using Large Language Models to transform natural language into actionable application commands.

demo.mp4

๐Ÿš€ Introduction

InteliPort addresses the growing commuting needs of students, professors, and staff across various universities in cities. Our system enables smart travel planning and booking between universities, aiming to reduce costs, save time, and enhance efficiency through advanced graph algorithms and AI-powered interactions.

๐Ÿง  User Intent Interface (UII)

InteliPort pioneers the User Intent Interface (UII) concept - a groundbreaking approach to user interaction that leverages Large Language Models to:

  • Transform natural language into application actions - Users can say "Find the shortest path from A to C" instead of clicking through menus
  • Provide visual feedback and confirmation - Every action is visualized on the graph with clear highlights and responses
  • Enable conversational computing - Complex graph operations become as simple as having a conversation
  • Reduce cognitive load - No need to learn specific UI patterns or remember button locations

Example UII Interactions:

  • "Show me the minimum spanning tree" โ†’ Automatically calculates and highlights MST
  • "Find the best route from university A to university D" โ†’ Runs Dijkstra's algorithm and visualizes the path
  • "Add a new university called 'Tech Campus'" โ†’ Creates a new node in the graph
  • "Delete the connection between B and C" โ†’ Removes the specified edge

๐ŸŽฏ Project Objectives

  • Design graph-based structures representing real-world university connections
  • Implement smart transportation and reservation systems using advanced algorithms
  • Analyze various scenarios using efficient graph algorithms
  • Visualize complex data through interactive graph representations
  • Pioneer UII technology for intuitive human-computer interaction

๐Ÿ—๏ธ System Architecture

Frontend (SvelteKit + TypeScript)

  • Interactive Graph Visualization using Cytoscape.js
  • Responsive Design with Tailwind CSS
  • Real-time UII Processing with natural language input
  • Dynamic Graph Manipulation with visual feedback

Backend (Node.js + Cerebras AI)

  • LLM-powered Intent Processing using Cerebras Cloud SDK
  • Graph Algorithm Implementations (Dijkstra, MST, TSP)
  • Tool-based Function Calling for precise graph operations
  • Contextual Graph Serialization for AI understanding

Core Technologies

  • SvelteKit 5 - Modern web framework with runes
  • Cytoscape.js - Graph visualization and manipulation
  • Cerebras AI - Large language model for intent processing
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first styling
  • Bun - Fast JavaScript runtime and package manager

๐ŸŒŸ Key Features

Phase 1: Graph Foundation โœ…

  • Weighted Graph Structure representing university connections
  • Minimum Spanning Tree (MST) using Kruskal's algorithm
  • Two-hop Reachability ensuring all universities are accessible
  • Dynamic Node Management with intelligent connection suggestions

Phase 2: Route Optimization โœ…

  • Dijkstra's Algorithm for shortest path finding
  • Visual Path Highlighting with different colors for traffic levels
  • Real-time Graph Manipulation through UII commands
  • Interactive Graph Controls with zoom, pan, and selection

Phase 3: Multi-Destination Planning ๐Ÿšง

  • Traveling Salesman Problem (TSP) using Held-Karp algorithm
  • Dynamic Programming with bitmasking for efficiency
  • Multi-stop Trip Optimization for complex itineraries

Phase 4: Scalable Architecture ๐Ÿšง

  • Geographic Graph Partitioning for large-scale operations
  • Distributed MST Computation across regions
  • Divide and Conquer strategies for computational efficiency

๐Ÿ› ๏ธ Installation & Setup

Prerequisites

  • Bun (recommended) or Node.js 18+
  • Git for version control

Quick Start

  1. Clone the repository
git clone <repository-url>
cd inteliport
  1. Install dependencies
bun install
  1. Set up environment variables
cp .env.example .env
# Add your CEREBRAS_API_KEY to .env
  1. Start development server
bun run dev
  1. Open in browser
http://localhost:5173

Building for Production

# Build the application
bun run build

# Preview the build
bun run preview

๐ŸŽฎ Usage Examples

Basic Graph Operations

User: "Find the shortest path from A to C"
System: Runs Dijkstra's algorithm and highlights the optimal route

User: "Add a new university called 'Engineering Campus'"
System: Creates new node and suggests optimal connections

Advanced Operations

User: "Create a minimum spanning tree"
System: Calculates MST using Kruskal's algorithm and highlights connections

User: "Check if all universities are reachable within 2 hops"
System: Analyzes graph connectivity and provides detailed report

User: "Delete the connection between B and D"
System: Removes edge and updates graph visualization

๐Ÿ“Š Algorithm Implementations

Graph Algorithms

  • Kruskal's MST - Minimum spanning tree construction
  • Dijkstra's Algorithm - Shortest path finding
  • BFS Reachability - Two-hop connectivity analysis
  • Dynamic Graph Updates - Real-time modifications

Data Structures

  • Priority Queues - Efficient algorithm implementations
  • Adjacency Lists - Graph representation
  • Bitmasking - TSP optimization (Phase 3)
  • Union-Find - MST construction

AI Integration

  • Function Calling - Precise tool execution
  • Context Serialization - Graph state representation
  • Intent Recognition - Natural language processing
  • Visual Feedback - Action confirmation

๐Ÿ”ง Development

Project Structure

inteliport/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ lib/
โ”‚   โ”‚   โ”œโ”€โ”€ graph/           # Graph algorithms
โ”‚   โ”‚   โ”œโ”€โ”€ agent.server.ts  # AI processing
โ”‚   โ”‚   โ”œโ”€โ”€ tools.server.ts  # Available functions
โ”‚   โ”‚   โ””โ”€โ”€ shared.svelte.ts # Global state
โ”‚   โ”œโ”€โ”€ routes/
โ”‚   โ”‚   โ”œโ”€โ”€ +page.svelte     # Main interface
โ”‚   โ”‚   โ”œโ”€โ”€ DisplayGraph.svelte # Graph visualization
โ”‚   โ”‚   โ””โ”€โ”€ Tools.ts         # Client-side tool handling
โ”‚   โ””โ”€โ”€ app.html             # HTML template
โ”œโ”€โ”€ static/                  # Static assets
โ””โ”€โ”€ package.json            # Dependencies

Key Components

UII Processing Pipeline

  1. Natural Language Input - User types intent
  2. LLM Analysis - Cerebras processes and identifies actions
  3. Function Calling - Specific tools are executed
  4. Visual Feedback - Graph updates with highlights
  5. Confirmation - User sees results immediately

Graph Visualization

  • Cytoscape.js Integration - Professional graph rendering
  • Interactive Controls - Zoom, pan, select functionality
  • Dynamic Styling - Color-coded paths and highlights
  • Responsive Design - Works on all screen sizes

๐ŸŽจ UI/UX Features

Conversational Interface

  • Natural Language Input - Type commands in plain English
  • Context-Aware Responses - System understands graph state
  • Visual Confirmations - Every action shows immediate results
  • Error Handling - Graceful fallbacks for invalid requests

Graph Visualization

  • Interactive Nodes - Click to select, right-click for context
  • Highlighted Paths - Color-coded routes and connections
  • Zoom & Pan - Explore large graphs easily
  • Responsive Layout - Mobile and desktop friendly

Navigation

  • Tabbed Interface - Graph, Profile, Settings sections
  • Mobile Navigation - Collapsible menu for small screens
  • Keyboard Shortcuts - Enter to submit, Escape to clear
  • Dark Mode Support - Automatic theme switching

๐Ÿš€ Future Enhancements

Phase 3 Roadmap

  • Capacity Management - Real-time booking system
  • Time-based Routing - Schedule-aware pathfinding

Phase 4 Scalability

  • Geographic Partitioning - Regional graph management
  • Distributed Computing - Parallel algorithm execution
  • Performance Optimization - Large-scale graph handling

UII Evolution

  • Voice Commands - Speech-to-text integration
  • Gesture Recognition - Touch-based graph manipulation
  • Predictive Suggestions - AI-powered recommendations
  • Multi-modal Input - Combine text, voice, and gestures

๐Ÿค Contributing

We welcome contributions to InteliPort! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Use TypeScript for type safety
  • Follow existing code style (Prettier configured)
  • Add tests for new algorithms
  • Document UII functions for AI integration
  • Update README for new features

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • Cytoscape.js - Powerful graph visualization library
  • SvelteKit - Modern web framework
  • Cerebras AI - Advanced language model capabilities
  • Open Source Community - Inspiration and resources

๐Ÿ“ง Contact

For questions, suggestions, or collaboration opportunities, please reach out:


InteliPort - Transforming university transportation through intelligent algorithms and revolutionary User Intent Interface technology. ๐Ÿš€๐ŸŽ“

About

InteliPort: AI-powered university transport with revolutionary UII ๐Ÿš€! Chat with our system using natural language to plan routes, analyze graphs, and visualize paths ๐Ÿ—บ๏ธ. Experience the future of human-computer interaction where complex algorithms respond to simple conversations ๐Ÿ’ฌ.

Resources

Stars

5 stars

Watchers

0 watching

Forks

Contributors