BIL

A multi-platform AI assistant system with desktop control, mobile app, and wearable device support.

🌟 Features

🤖 AI Assistant

Gemini AI Integration - Powered by Google's Gemini AI
Natural Language Processing - Conversational AI interactions
Context-Aware Responses - Remembers conversation history
Multi-Device Sync - Seamless experience across devices

💻 Desktop Control

Remote Desktop Control - Control your computer from your phone
Application Launcher - Open Steam, CS2, Spotify, Chrome, etc.
Command Execution - Run shell commands remotely
SSH Support - Connect to servers from your desktop
Cross-Platform - Windows, macOS, and Linux support

📱 Mobile App

React Native - iOS and Android support
Voice Input - Talk to your AI assistant
Desktop Control - Control your computer remotely
Device Management - Manage connected devices
Offline Support - Works without internet

🖥️ Desktop App

Electron-based - Native desktop experience
System Tray - Runs in background
Floating Window - Quick access assistant
Global Shortcuts - Keyboard shortcuts for quick access
Auto-updates - Automatic updates via Electron

⌚ Wearable Support

ESP32-based - Custom wearable device
Gesture Control - Control with hand gestures
Voice Detection - Wake word detection
Haptic Feedback - Vibration feedback
BLE Communication - Bluetooth Low Energy

🚀 Quick Start

Prerequisites

Node.js 18+ (Download)
Docker (Download)
Git (Download)

Installation

# Clone the repository
git clone https://github.com/dilyorm/bil.git
cd bil

# Install dependencies
npm install

# Start PostgreSQL and Redis
docker-compose -f docker-compose.dev.yml up -d

# Setup environment variables
cp packages/backend/.env.example packages/backend/.env
# Edit packages/backend/.env and add your API keys

# Start backend
cd packages/backend
npm run dev

# Start desktop app (new terminal)
cd packages/desktop
npm run dev

# Start mobile app (new terminal)
cd packages/mobile
npx expo start

📚 Documentation

Quick Start Guide - Get started in 5 minutes
Desktop Control Guide - Complete desktop control documentation
Desktop App Guide - Desktop application documentation
Production Setup - Deploy to production
Security Guide - Security best practices

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                     BIL System                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐            │
│  │  Mobile  │  │ Desktop  │  │ Wearable │            │
│  │   App    │  │   App    │  │  Device  │            │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘            │
│       │             │              │                   │
│       └─────────────┼──────────────┘                   │
│                     │                                   │
│              ┌──────▼──────┐                           │
│              │   Backend   │                           │
│              │     API     │                           │
│              └──────┬──────┘                           │
│                     │                                   │
│       ┌─────────────┼─────────────┐                   │
│       │             │             │                   │
│  ┌────▼────┐  ┌────▼────┐  ┌────▼────┐              │
│  │ Gemini  │  │PostgreSQL│  │  Redis  │              │
│  │   AI    │  │ Database │  │  Cache  │              │
│  └─────────┘  └─────────┘  └─────────┘              │
│                                                         │
└─────────────────────────────────────────────────────────┘

🛠️ Tech Stack

Backend

Node.js + TypeScript - Runtime and language
Express - Web framework
PostgreSQL - Primary database
Redis - Caching and pub/sub
WebSocket - Real-time communication
JWT - Authentication

Desktop

Electron - Desktop framework
React - UI framework
TypeScript - Type safety
Vite - Build tool

Mobile

React Native - Mobile framework
Expo - Development platform
TypeScript - Type safety

Wearable

ESP32 - Microcontroller
C++ - Programming language
BLE - Communication protocol

AI

Google Gemini - Primary AI model
OpenAI (optional) - Alternative AI model

📦 Project Structure

bil/
├── packages/
│   ├── backend/          # Node.js backend API
│   ├── desktop/          # Electron desktop app
│   ├── mobile/           # React Native mobile app
│   └── wearable/         # ESP32 firmware
├── infrastructure/       # Deployment configs
│   ├── k8s/             # Kubernetes manifests
│   ├── terraform/       # Terraform configs
│   └── nginx/           # Nginx configs
├── scripts/             # Utility scripts
├── tests/               # Integration tests
└── docs/                # Documentation

🔧 Configuration

Backend Configuration

Edit packages/backend/.env:

# Required
GEMINI_API_KEY=your_api_key_here
DATABASE_URL=postgresql://user:pass@localhost:5432/bil
JWT_SECRET=your_secret_here

# Optional
OPENAI_API_KEY=your_openai_key
REDIS_URL=redis://localhost:6379

Desktop Configuration

Edit packages/desktop/.env:

VITE_API_URL=http://localhost:3000

Mobile Configuration

Edit packages/mobile/src/config/constants.ts:

export const API_URL = 'http://localhost:3000';

🧪 Testing

# Run all tests
npm test

# Run backend tests
cd packages/backend
npm test

# Run desktop tests
cd packages/desktop
npm test

# Run mobile tests
cd packages/mobile
npm test

🚀 Deployment

Deploy to Railway

# Install Railway CLI
npm install -g @railway/cli

# Login
railway login

# Deploy
railway up

Deploy to AWS

# Configure AWS credentials
aws configure

# Deploy with Terraform
cd infrastructure/terraform
terraform init
terraform apply

Deploy with Docker

# Build images
docker-compose build

# Start services
docker-compose up -d

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide first.

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

📄 License

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

🙏 Acknowledgments

Google Gemini - AI capabilities
Electron - Desktop framework
React Native - Mobile framework
Expo - Mobile development platform

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Email: support@bil.example.com

🗺️ Roadmap

⭐ Star History

Made with ❤️ by the BIL Team

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
.github/workflows		.github/workflows
.husky		.husky
.kiro/specs/bil-core-system		.kiro/specs/bil-core-system
infrastructure		infrastructure
packages		packages
scripts		scripts
tests/api		tests/api
.eslintrc.js		.eslintrc.js
.gitattributes		.gitattributes
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc		.prettierrc
CONFIGURATION_CHECKLIST.md		CONFIGURATION_CHECKLIST.md
CONTRIBUTING.md		CONTRIBUTING.md
DESKTOP_APP_GUIDE.md		DESKTOP_APP_GUIDE.md
DESKTOP_CONTROL_GUIDE.md		DESKTOP_CONTROL_GUIDE.md
DESKTOP_CONTROL_SETUP.md		DESKTOP_CONTROL_SETUP.md
GITHUB_PUSH_CHECKLIST.md		GITHUB_PUSH_CHECKLIST.md
GITHUB_SETUP.md		GITHUB_SETUP.md
LICENSE		LICENSE
MVP_FREE_SETUP.md		MVP_FREE_SETUP.md
README.md		README.md
docker-compose.dev.yml		docker-compose.dev.yml
docker-compose.prod.yml		docker-compose.prod.yml
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

BIL