universal-ai-cli

Universal AI CLI

🤖 A unified command-line interface for multiple AI providers including Gemini, OpenAI, Anthropic, Doubao, and more.

✨ Features

• 🔄 Multi-Provider Support: Gemini, OpenAI, Anthropic, Doubao, DeepSeek, and any OpenAI-compatible API
• 💭 Thinking Mode: Real-time display of AI reasoning process (when supported)
• 🔧 Universal Configuration: Simple environment variables work across all providers
• 🚀 Streaming Responses: Real-time response streaming with thinking process visualization
• 📝 Context Preservation: Maintains conversation history across interactions
• 🛠️ Tool Integration: Supports function calling and tool usage
• 🎯 Easy Setup: Get started in seconds with any AI provider

🚀 Quick Start

Installation

# Global installation
npm install -g universal-ai-cli

# Or use directly with npx
npx universal-ai-cli

Basic Usage

# Start interactive mode
uai

# Or use the full command
universal-ai

Configuration

Create a .env file or set environment variables:

# Example: Using Gemini
AI_PROVIDER=gemini
AI_API_KEY=your_gemini_api_key
AI_MODEL=gemini-2.5-pro

# Example: Using OpenAI
AI_PROVIDER=openai
AI_API_KEY=your_openai_api_key
AI_MODEL=gpt-4o
AI_BASE_URL=https://api.openai.com/v1

# Example: Using Doubao
AI_PROVIDER=doubao
AI_API_KEY=your_doubao_api_key
AI_MODEL=doubao-pro-4k
AI_BASE_URL=https://ark.cn-beijing.volces.com/api/v3

# Example: Using Anthropic
AI_PROVIDER=anthropic
AI_API_KEY=your_anthropic_api_key
AI_MODEL=claude-3-5-sonnet-20241022
AI_BASE_URL=https://api.anthropic.com

🎯 Supported Providers

Provider	Status	Thinking Mode	Models
Gemini	✅ Full Support	✅ Native	gemini-2.5-pro, gemini-2.5-flash
OpenAI	✅ Full Support	✅ o1 Series	gpt-4o, gpt-4, o1-preview, o1-mini
Anthropic	✅ Full Support	❌	claude-3-5-sonnet, claude-3-haiku
Doubao	✅ Full Support	✅ Thinking Models	doubao-pro-4k, doubao-thinking
DeepSeek	✅ OpenAI Compatible	✅ V3 Series	deepseek-chat, deepseek-coder
Custom	✅ OpenAI Compatible	⚠️ Depends on API	Any OpenAI-compatible API

🛠️ Environment Variables

Variable	Required	Description	Example
AI_PROVIDER	✅	AI service provider	gemini, openai, anthropic, doubao
AI_API_KEY	✅	API key for the provider	your_api_key_here
AI_MODEL	✅	Model name	gemini-2.5-pro, gpt-4o
AI_BASE_URL	❌	Custom API endpoint	https://api.example.com/v1
AI_THINK_SUPPORT	❌	Force enable/disable thinking	true, false
AI_EMBEDDING_MODEL	❌	Custom embedding model	text-embedding-3-small

💭 Thinking Mode

When enabled, you'll see the AI's reasoning process in real-time:

🤔 Thinking: Let me analyze this step by step...
   1. First, I need to understand the user's request
   2. Then I'll search for relevant information
   3. Finally, I'll formulate a comprehensive response

💬 Response: Based on my analysis, here's what I found...

🔧 Advanced Usage

Custom Provider Setup

# Using a custom OpenAI-compatible API
AI_PROVIDER=openai
AI_API_KEY=your_custom_key
AI_MODEL=your_custom_model
AI_BASE_URL=https://your-api-endpoint.com/v1

Development Mode

# Enable debug logging
DEBUG=1 uai

# Or with environment variable
export DEBUG=1
uai

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Based on the excellent Gemini CLI by Google, extended to support multiple AI providers.

📞 Support

• 🐛 Report Issues
• 💡 Request Features
• 📖 Documentation
• 💬 Discussions