Skip to content

๐Ÿš€ Claude Code API | CLI to API Platform | Transform Claude CLI, Gemini CLI, Cursor CLI into REST APIs | One-Click Deploy | Web Terminal

License

Notifications You must be signed in to change notification settings

aixier/AI_Terminal

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

AI Terminal - World's First AI-Powered Web Terminal Platform

๐Ÿš€ Revolutionary AI-Powered Web Terminal

One line: let AI run the commands for you. No terminal skills needed; power users go faster.

AI Terminal is the world's first open-source web-based terminal platform that seamlessly integrates multiple AI assistants (Claude AI + Gemini AI) with a production-ready terminal interface. Transform your development workflow with intelligent code assistance, real-time collaboration, and enterprise-grade AI tools - all accessible through your browser.

๐ŸŽฏ Perfect for: Developers, Researchers, DevOps Teams, AI Enthusiasts, Educational Institutions, and Enterprise Development Teams

โœจ What Makes AI Terminal Unique?

๐ŸŒŸ World's First AI-Integrated Web Terminal - Breakthrough innovation in developer tools
๐Ÿค– Dual AI Engine - Claude AI + Gemini AI working together
๐ŸŒ Zero Installation - Runs entirely in your browser
๐Ÿณ One-Click Deploy - Docker-ready for instant setup
๐Ÿ”ง Production Ready - Enterprise-grade architecture
๐Ÿ“ฑ Cross-Platform - Desktop, tablet, and mobile support


๐ŸŽ‰ Latest Release: v3.61.1 "Terminal Engine Revolution"

๐Ÿ†• Revolutionary Terminal Performance Upgrade

  • ๐Ÿš€ Custom Terminal Engine - Built from scratch, replacing heavy xterm.js with lightweight solution
  • ๐Ÿ“ฑ Mobile-First Terminal - Optimized touch interface with native mobile keyboard support
  • โšก 90% Performance Boost - Reduced memory usage and faster rendering on all devices
  • ๐Ÿ–ฅ๏ธ Iframe Integration - Seamless embedded terminal experience across desktop and mobile
  • ๐ŸŽฏ Unified Architecture - Single terminal engine powering all interfaces
  • ๐Ÿ”„ Smart Session Management - Auto-reconnect, session persistence, and error recovery

๐Ÿš€ Quick Start (30 Seconds)

Option 1: Public Image (Development/Testing)

# Deploy with environment variables
docker run -d -p 6000:6000 \
  -e ANTHROPIC_AUTH_TOKEN="your_claude_token" \
  -e ANTHROPIC_BASE_URL="your_claude_api_url" \
  coopotfan/ai-terminal:latest

# Open browser and visit: http://localhost:6000

Option 2: Production Image (Ready to Use)

# Deploy instantly - no configuration needed
docker run -d -p 6000:6000 coopotfan/ai-terminal:production

# Open browser and visit: http://localhost:6000
# โœ… Pre-configured and ready to use!

๐ŸŒŸ Core Features & Capabilities

๐Ÿค– Multi-AI Integration Engine

  • Claude AI Integration - Advanced reasoning, code generation, and analysis
  • Gemini AI Integration - Versatile content creation and multimodal AI
  • Manual Initialization System - On-demand AI tool setup with visual feedback
  • Smart Context Management - Persistent AI conversation context
  • Error Recovery - Automatic AI session restoration

๐ŸŒ Next-Generation Terminal Engine

  • Custom Terminal Engine - Revolutionary lightweight terminal implementation
  • Mobile-Optimized Architecture - Touch-first design with native keyboard support
  • Iframe Integration - Seamless embedding across desktop and mobile platforms
  • Real-time WebSocket Communication - Ultra-low latency bidirectional communication
  • Smart Session Management - Auto-reconnect, state recovery, and session persistence
  • Cross-Platform Excellence - Optimized performance on Windows, macOS, Linux, iOS, Android

๐Ÿ“Š Knowledge Card Generation System

  • AI-Powered Content Creation - Generate structured knowledge cards
  • Multiple Template System - Professional layouts for different content types
  • Real-time Preview - Instant preview with responsive design testing
  • Export Capabilities - HTML, JSON, and shareable link formats
  • Template Management - Upload, customize, and share templates

๐Ÿ”ง Developer Experience

  • REST API Gateway - Convert terminal commands to HTTP APIs
  • Streaming Support - Real-time output streaming for long-running processes
  • Environment Management - Flexible configuration via environment variables
  • Logging & Monitoring - Comprehensive logging with structured output
  • Security Features - JWT authentication, CORS protection, input validation

๐ŸŽจ Modern UI/UX Design

  • Fluent Design System - Microsoft Fluent UI components
  • Responsive Layout - Optimized for all screen sizes and orientations
  • Dark Theme Optimized - Eye-friendly interface for extended coding sessions
  • Real-time Indicators - Visual feedback for all operations and status
  • Accessibility Features - WCAG compliant interface design

๐Ÿš€ Installation & Deployment

Option 1: Docker Deployment (Recommended)

Public Image (Development/Open Source)

# Basic deployment with environment variables
docker run -d \
  --name ai-terminal \
  -p 6000:6000 \
  -e ANTHROPIC_AUTH_TOKEN="your_claude_token" \
  -e ANTHROPIC_BASE_URL="your_claude_api_url" \
  -e GEMINI_API_KEY="your_gemini_key" \
  coopotfan/ai-terminal:latest

# Advanced deployment with persistence
docker run -d \
  --name ai-terminal \
  -p 6000:6000 \
  -e ANTHROPIC_AUTH_TOKEN="your_claude_token" \
  -e ANTHROPIC_BASE_URL="your_claude_api_url" \
  -e GEMINI_API_KEY="your_gemini_key" \
  -e NODE_ENV=production \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  --restart unless-stopped \
  coopotfan/ai-terminal:latest

Production Image (Internal Deployment)

# Ready-to-use deployment (no environment variables needed)
docker run -d \
  --name ai-terminal \
  -p 6000:6000 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/logs:/app/logs \
  --restart unless-stopped \
  coopotfan/ai-terminal:production

Option 2: Docker Compose

version: '3.8'
services:
  ai-terminal:
    image: coopotfan/ai-terminal:latest
    container_name: ai-terminal
    ports:
      - "6000:6000"
    environment:
      - NODE_ENV=production
      - ANTHROPIC_AUTH_TOKEN=${ANTHROPIC_AUTH_TOKEN}
      - GEMINI_API_KEY=${GEMINI_API_KEY}
      - MAX_TERMINAL_SESSIONS=20
      - TERMINAL_TIMEOUT=1800000
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs
    restart: unless-stopped

Option 3: Development Setup

# Clone repository
git clone https://github.com/aixier/AI_Terminal.git
cd AI_Terminal

# Install dependencies
npm install

# Set environment variables
cp .env.example .env
# Edit .env with your AI API tokens

# Start backend dev server
cd terminal-backend
npm install
npm run dev

# Start frontend dev server (new terminal)
cd terminal-ui
npm install
npm run dev

# Visit http://localhost:5173

๐Ÿ”ง Configuration & Environment

Essential Environment Variables

# AI Service Configuration
ANTHROPIC_AUTH_TOKEN=your_claude_api_token
ANTHROPIC_BASE_URL=https://api.anthropic.com
GEMINI_API_KEY=your_google_gemini_key

# Server Configuration
PORT=6000
NODE_ENV=production
HOST=0.0.0.0

# Security Configuration
JWT_SECRET=your_secure_jwt_secret
JWT_EXPIRE_TIME=24h
CORS_ORIGINS=*

# Terminal Configuration
MAX_TERMINAL_SESSIONS=10
TERMINAL_TIMEOUT=600000
ENABLE_TERMINAL_LOGGING=true

# Performance Configuration
MEMORY_LIMIT=512m
CPU_LIMIT=1.0
WORKER_PROCESSES=1

Advanced Configuration

# Database Configuration (Optional)
DATABASE_URL=postgresql://user:pass@host:5432/db

# Redis Configuration (Optional)
REDIS_URL=redis://localhost:6379

# Monitoring Configuration
ENABLE_METRICS=true
METRICS_PORT=9090
LOG_LEVEL=info

๐Ÿ“– Usage Examples & Tutorials

Basic AI Assistant Usage

# 1. Open AI Terminal in browser
# 2. Click ๐Ÿค– to initialize Claude AI
# 3. Start coding with AI assistance

# Example commands:
claude "explain this error message"
claude "optimize this code for performance"
claude "generate unit tests for this function"

Knowledge Card Generation

# 1. Navigate to "Generate Card" tab
# 2. Enter topic: "Machine Learning Fundamentals"
# 3. Select template style
# 4. Generate and export

# Supported formats:
- HTML with embedded CSS
- JSON structured data
- Shareable public links
- PDF export (coming soon)

API Integration Examples

// REST API usage
const response = await fetch('/api/terminal/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    command: 'npm install express',
    stream: true
  })
});

// WebSocket streaming
const ws = new WebSocket('ws://localhost:6000/terminal');
ws.onmessage = (event) => {
  console.log('Terminal output:', event.data);
};

๐Ÿ—๏ธ Architecture & Technology Stack

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Frontend      โ”‚    Backend      โ”‚   AI Services   โ”‚   Infrastructureโ”‚
โ”‚   (Vue 3)       โ”‚   (Node.js)     โ”‚  (Claude/Gemini)โ”‚   (Docker)      โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ โ€ข Vue 3 + Vite  โ”‚ โ€ข Express.js    โ”‚ โ€ข Claude API    โ”‚ โ€ข Docker Multi- โ”‚
โ”‚ โ€ข Custom Engine โ”‚ โ€ข Socket.IO     โ”‚ โ€ข Gemini API    โ”‚   stage Build   โ”‚
โ”‚ โ€ข Iframe Embed  โ”‚ โ€ข node-pty      โ”‚ โ€ข OpenAI (soon) โ”‚ โ€ข Health Checks โ”‚
โ”‚ โ€ข WebSocket     โ”‚ โ€ข JWT Auth      โ”‚ โ€ข Streaming     โ”‚ โ€ข Auto Scaling  โ”‚
โ”‚ โ€ข Mobile First  โ”‚ โ€ข CORS Security โ”‚ โ€ข Context Mgmt  โ”‚ โ€ข Load Balancer โ”‚
โ”‚ โ€ข PWA Ready     โ”‚ โ€ข Rate Limiting โ”‚ โ€ข Error Recoveryโ”‚ โ€ข SSL/TLS      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Key Technologies

  • Frontend: Vue.js 3, Vite, xterm.js, Microsoft Fluent UI
  • Backend: Node.js, Express.js, Socket.IO, node-pty
  • AI Integration: Anthropic Claude API, Google Gemini API
  • Containerization: Docker, Docker Compose
  • Security: JWT, CORS, Input Validation, Rate Limiting

๐ŸŽฏ Use Cases & Applications

For Software Developers

  • AI-Powered Code Assistant - Get intelligent code suggestions and explanations
  • Terminal Collaboration - Share terminal sessions with team members
  • API Development - Convert command-line tools to REST APIs
  • Code Documentation - Generate comprehensive documentation with AI

For DevOps Engineers

  • Infrastructure Management - Manage servers through web interface
  • Deployment Automation - Create deployment scripts with AI assistance
  • Monitoring Integration - Combine terminal access with monitoring tools
  • Team Collaboration - Share terminal access across teams

For Researchers & Data Scientists

  • Data Analysis Workflows - AI-assisted data exploration and analysis
  • Experiment Documentation - Generate research cards and reports
  • Model Development - Interactive AI development environment
  • Results Sharing - Create shareable analysis results

For Educational Institutions

  • Computer Science Education - Teach programming with AI assistance
  • Remote Learning - Provide browser-based development environments
  • Student Collaboration - Enable group programming projects
  • Course Content Creation - Generate educational materials with AI

For Enterprise Teams

  • Secure AI Access - Self-hosted AI tools for sensitive projects
  • Team Productivity - Standardized development environments
  • Knowledge Management - Create and share team knowledge bases
  • Training & Onboarding - Interactive learning environments

๐Ÿ“Š Performance & Scalability

Performance Metrics

  • Startup Time: < 10 seconds (container ready)
  • Memory Usage: ~200MB base, ~50MB per terminal session
  • Response Time: < 100ms for UI interactions
  • Concurrent Users: Up to 100+ (depending on resources)
  • AI Response Time: 1-5 seconds (depends on AI service)

Scalability Features

  • Horizontal Scaling - Multiple container instances
  • Load Balancing - Built-in session affinity
  • Resource Management - Configurable limits per session
  • Auto-scaling - Kubernetes compatible
  • Monitoring Integration - Prometheus metrics ready

๐Ÿ›ก๏ธ Security & Privacy

Security Features

  • JWT Authentication - Secure session management
  • CORS Protection - Configurable cross-origin policies
  • Input Validation - Comprehensive input sanitization
  • Rate Limiting - Prevent abuse and DOS attacks
  • Secure Headers - HTTPS, CSP, HSTS support

Privacy Guarantees

  • No Data Persistence - AI conversations are not stored by default
  • Local Processing - All terminal operations happen locally
  • Token Security - API tokens stored securely in environment
  • Audit Logging - Comprehensive activity logging
  • GDPR Compliant - Designed with privacy regulations in mind

๐Ÿค Contributing & Community

We welcome contributions from developers worldwide! This project thrives on community collaboration.

How to Contribute

  1. ๐Ÿด Fork the Repository
  2. ๐ŸŒฟ Create Feature Branch: git checkout -b feature/amazing-feature
  3. ๐Ÿ’ป Make Your Changes: Follow our coding standards
  4. โœ… Test Your Changes: Ensure all tests pass
  5. ๐Ÿ“ Commit Changes: git commit -m 'Add amazing feature'
  6. ๐Ÿš€ Push to Branch: git push origin feature/amazing-feature
  7. ๐Ÿ”„ Open Pull Request: Describe your changes thoroughly

Development Guidelines

  • Code Style: ESLint + Prettier configuration
  • Testing: Jest for unit tests, Cypress for E2E
  • Documentation: JSDoc comments for all functions
  • Security: Security audit for all contributions
  • Performance: Performance impact assessment

Community Resources


๐Ÿ“‹ System Requirements

Minimum Requirements

  • OS: Windows 10+, macOS 10.15+, Linux (any modern distro)
  • Browser: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
  • Memory: 2GB RAM available
  • Storage: 1GB free space
  • Network: Stable internet connection for AI services

Recommended Requirements

  • OS: Latest versions of Windows, macOS, or Linux
  • Browser: Latest Chrome or Firefox for best performance
  • Memory: 4GB+ RAM for multiple sessions
  • Storage: 5GB+ for data persistence
  • Network: High-speed internet for optimal AI response times

Docker Requirements

  • Docker: v20.10+
  • Docker Compose: v2.0+ (optional)
  • Resources: 2 CPU cores, 2GB RAM minimum

๐Ÿ› Troubleshooting & Support

Common Issues & Solutions

AI Initialization Problems

# Problem: Claude initialization fails
# Solution: Check API token and network connectivity
docker logs ai-terminal 2>&1 | grep -i "claude"

# Problem: Gemini not responding
# Solution: Verify Gemini API key and quota
curl -H "Authorization: Bearer $GEMINI_API_KEY" https://api.gemini.com/health

Terminal Connection Issues

# Problem: WebSocket connection fails
# Solution: Check firewall and proxy settings
# Enable debug logging
docker run -e LOG_LEVEL=debug coopotfan/ai-terminal:latest

Performance Issues

# Problem: Slow response times
# Solution: Increase container resources
docker run --memory=1g --cpus=2 coopotfan/ai-terminal:latest

Getting Help


๐Ÿ—บ๏ธ Roadmap & Future Plans

Q1 2025 - Core Enhancements

  • Multi-Model AI Support - OpenAI GPT, Anthropic Claude 3.5
  • Advanced Terminal Features - Split panes, tabs, session saving
  • Enhanced Security - SSO integration, RBAC, audit trails
  • Mobile App - Native iOS/Android applications

Q2 2025 - Enterprise Features

  • Team Collaboration - Real-time collaborative editing
  • Enterprise SSO - SAML, OIDC, Active Directory integration
  • Advanced Analytics - Usage analytics, performance metrics
  • API Gateway - Advanced rate limiting, API versioning

Q3 2025 - AI Innovations

  • Custom AI Models - Support for fine-tuned models
  • AI Workflow Builder - Visual AI workflow designer
  • Advanced Knowledge Cards - Interactive, multimedia cards
  • AI Code Reviews - Automated code review with AI

Q4 2025 - Platform Evolution

  • Plugin System - Third-party plugin support
  • Marketplace - Template and plugin marketplace
  • Enterprise Cloud - Managed cloud service
  • AI Training - Train custom models on your data

๐Ÿ“„ License & Legal

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

What this means:

  • โœ… Commercial Use - Use in commercial projects
  • โœ… Modification - Modify and adapt the code
  • โœ… Distribution - Distribute original or modified versions
  • โœ… Private Use - Use privately without sharing changes
  • โ— No Liability - Software provided "as is"
  • โ— No Warranty - No guarantees about software performance

Attribution

If you use AI Terminal in your project, we appreciate attribution:

Powered by AI Terminal - https://github.com/aixier/AI_Terminal

๐ŸŒŸ Star History & Recognition

Star History Chart

Awards & Recognition

  • ๐Ÿ† GitHub Trending - Featured in trending repositories
  • ๐ŸŒŸ Developer Choice - High community rating
  • ๐Ÿš€ Innovation Award - Recognized for AI integration breakthrough
  • ๐Ÿ’Ž Open Source Excellence - Community-driven development model

๐Ÿ’– Support the Project

If AI Terminal has helped you or your team, consider supporting our development:

Ways to Support

  • โญ Star the Repository - Help others discover the project
  • ๐Ÿ› Report Bugs - Help us improve quality
  • ๐Ÿ’ก Suggest Features - Share your ideas for improvements
  • ๐Ÿ”„ Contribute Code - Submit pull requests
  • ๐Ÿ“ข Share with Others - Spread the word about AI Terminal
  • โ˜• Buy us a Coffee - Support on Ko-fi

Corporate Sponsorship

Interested in corporate sponsorship or custom development? Contact us at sponsor@ai-terminal.com


๐Ÿ“ž Contact & Social


๐ŸŽฏ Built for developers, by developers

Made with โค๏ธ by the global open source community

โฌ†๏ธ Back to Top


Keywords: ai-terminal, web-terminal, claude-ai, gemini-ai, browser-terminal, ai-powered-development, terminal-emulator, web-based-terminal, ai-assistant, developer-tools, open-source, docker-deployment, vue3-application, nodejs-backend, xterm-js, ai-integration, knowledge-cards, real-time-collaboration, enterprise-ai-tools