# Quotio

Quotio Banner

Platform macOS Language Swift License MIT Discord English Chinese French

nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift nguyenphutrong%2Fquotio | Trendshift

Trung tâm điều khiển cho các trợ lý lập trình AI trên macOS.

Quotio là ứng dụng macOS để quản lý **CLIProxyAPI** - máy chủ proxy cục bộ cung cấp sức mạnh cho các agent lập trình AI. Quotio giúp bạn quản lý nhiều tài khoản AI, theo dõi hạn mức sử dụng và cấu hình các công cụ CLI tại một nơi. ## ✨ Tính năng - **🔌 Hỗ trợ Đa nhà cung cấp**: Kết nối tài khoản từ Claude, OpenAI Codex, Qwen, Vertex AI, iFlow, Antigravity, Kiro, Trae, và GitHub Copilot qua OAuth hoặc API key. - **📊 Chế độ Quota độc lập**: Xem quota và tài khoản mà không cần chạy proxy server - hoàn hảo để kiểm tra nhanh. - **🚀 Cấu hình Agent Một chạm**: Tự động phát hiện và cấu hình các công cụ như Claude Code, OpenCode. - **📈 Dashboard Thời gian thực**: Giám sát lưu lượng, token sử dụng và tỷ lệ thành công. - **📉 Quản lý Hạn mức**: Theo dõi quota từng tài khoản với chiến lược chuyển đổi tự động (Round Robin / Fill First). - **🔑 Quản lý API Key**: Tạo và quản lý các khóa API cho proxy. - **🖥️ Menu Bar**: Truy cập nhanh trạng thái, tổng quan quota và biểu tượng provider tùy chỉnh từ thanh menu. - **🔔 Thông báo**: Cảnh báo khi hạn mức thấp, tài khoản đang nghỉ, hoặc lỗi dịch vụ. - **🔄 Tự động Cập nhật**: Tích hợp Sparkle updater để cập nhật liền mạch. - **🌍 Đa ngôn ngữ**: Hỗ trợ tiếng Anh, tiếng Việt và tiếng Trung giản thể. ## 🤖 Hệ sinh thái hỗ trợ ### Nhà cung cấp AI | Provider | Phương thức xác thực | |----------|----------------------| | Anthropic Claude | OAuth | | OpenAI Codex | OAuth | | Qwen Code | OAuth | | Vertex AI | Service Account JSON | | iFlow | OAuth | | Antigravity | OAuth | | Kiro | OAuth | | GitHub Copilot | OAuth | ### Theo dõi Quota IDE (Chỉ giám sát) | IDE | Mô tả | |-----|-------| | Cursor | Tự động phát hiện khi cài đặt và đăng nhập | | Trae | Tự động phát hiện khi cài đặt và đăng nhập | > **Lưu ý**: Các IDE này chỉ dùng để theo dõi quota. Không thể sử dụng làm provider cho proxy. ### Agent tương thích Quotio có thể tự động cấu hình các công cụ sau: - Claude Code - Codex CLI - Amp CLI - OpenCode - Factory Droid ## 🚀 Cài đặt ### Yêu cầu - macOS 14.0 (Sonoma) trở lên - Kết nối internet để xác thực OAuth ### Homebrew (Khuyến nghị) ```bash brew tap nguyenphutrong/tap brew install --cask quotio ``` ### Tải xuống Tải file `.dmg` mới nhất từ trang [Releases](https://github.com/nguyenphutrong/quotio/releases). > ⚠️ **Lưu ý**: Ứng dụng chưa được ký bằng chứng chỉ Apple Developer. Nếu macOS chặn ứng dụng, chạy lệnh sau: > ```bash > xattr -cr /Applications/Quotio.app > ``` ### Build từ source 1. **Clone repo:** ```bash git clone https://github.com/nguyenphutrong/quotio.git cd Quotio ``` 2. **Mở trong Xcode:** ```bash open Quotio.xcodeproj ``` 3. **Build và chạy:** - Chọn scheme "Quotio" - Nhấn `Cmd + R` > Ứng dụng sẽ tự động tải binary `CLIProxyAPI` trong lần chạy đầu tiên. ## 📖 Hướng dẫn sử dụng ### 1. Khởi động Server Mở Quotio và nhấn **Start** trên dashboard để khởi động proxy server. ### 2. Kết nối Tài khoản Vào tab **Providers** → Chọn provider → Xác thực qua OAuth hoặc import credentials. ### 3. Cấu hình Agent Vào tab **Agents** → Chọn agent đã cài → Nhấn **Configure** → Chọn Automatic hoặc Manual. ### 4. Giám sát - **Dashboard**: Tình trạng chung và lưu lượng - **Quota**: Chi tiết sử dụng từng tài khoản - **Logs**: Nhật ký request/response để debug ## ⚙️ Cài đặt - **Port**: Đổi cổng proxy - **Chiến lược định tuyến**: Round Robin hoặc Fill First - **Auto-start**: Tự động khởi động proxy khi mở app - **Notifications**: Bật/tắt thông báo ## 📸 Hình ảnh ### Bảng điều khiển Bảng điều khiển ### Nhà cung cấp Nhà cung cấp ### Cài đặt Agent Cài đặt Agent ### Giám sát Hạn mức Giám sát Hạn mức ### Cấu hình Fallback Cấu hình Fallback ### API Keys API Keys ### Nhật ký Nhật ký ### Cài đặt Cài đặt ### Menu Bar Menu Bar ## 🤝 Đóng góp 1. Fork dự án 2. Tạo nhánh (`git checkout -b feature/tinh-nang-moi`) 3. Commit (`git commit -m 'Thêm tính năng mới'`) 4. Push (`git push origin feature/tinh-nang-moi`) 5. Mở Pull Request ## 💬 Cộng đồng Tham gia cộng đồng Discord để được hỗ trợ, chia sẻ phản hồi và kết nối với người dùng khác: Tham gia Discord ## ⭐ Star History Star History Chart ## 📊 Hoạt động Repo ![Repo Activity](https://repobeats.axiom.co/api/embed/884e7349c8939bfd4bdba4bc582b6fdc0ecc21ee.svg "Repobeats analytics image") ## 💖 Người đóng góp Chúng tôi không thể làm được điều này nếu thiếu các bạn. Cảm ơn! 🙏 ## 📄 Giấy phép MIT License. Xem file `LICENSE` để biết thêm.