Skip to content

razerofficial/aikit


⚠️ Preview Release

Razer AIKit is in preview. Features may change or have limitations before stable release. We appreciate your feedback!


What is Razer AIKit?

Open-source AI development environment for engineers and researchers. Delivers cloud-grade performance and scalability directly on your desktop with out-of-the-box setup.

Technical Stack

  • AIKit CLI - Command-line interface for model lifecycle management
  • vLLM Engine - Production-grade LLM inference with memory optimization
  • LlamaFactory - Parameter-efficient fine-tuning framework
  • Ray - Distributed computing for seamless multi-GPU scaling

Core Features

πŸš€ Local-First AI Development

Run 280,000+ LLMs locally with full privacy and zero cloud costs.

πŸ”§ Open-Source and Community-Driven

Apache 2.0 licensed with extensible architecture for custom workflows.

🌐 Intelligent Multi-GPU Scaling

Ray-based orchestration with automatic resource discovery and load balancing.

🎯 Production-Ready Inference

vLLM engine with memory optimization, batched inference, and OpenAI-compatible APIs.


Quick Start

Prerequisites

Windows 11

Note: Razer AIKit runs inside WSL 2 on Windows for optimal performance and compatibility.

  • NVIDIA GPU Driver - Install NVIDIA App and select Studio Driver for best stability

  • WSL 2 - Microsoft's guide

    • Install 24.04 distribution
    • Configure networking mode to Mirrored in WSL Settings
    • Configure Windows Firewall for WSL: Run the following command in PowerShell as Administrator to allow incoming connections to WSL:
      Set-NetFirewallHyperVVMSetting -Name '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -DefaultInboundAction Allow
  • Docker Engine (WSL) - Install guide

  • NVIDIA Container Toolkit (WSL) - Installation instructions

Verify installation:

nvidia-smi
Ubuntu 22.04 / 24.04

Verify installation:

nvidia-smi

⚑ Quick Start & Your First Model

# Create huggingface cache directory if it doesn't exist
mkdir -p $HOME/.cache/huggingface

# Pull and run Razer AIKIT
docker run -it \
  --restart=unless-stopped \
  --gpus all \
  --ipc host \
  --network host \
  --mount type=bind,source=$HOME/.cache/huggingface,target=/home/Razer/.cache/huggingface \
  --env HUGGING_FACE_HUB_TOKEN=<YOUR_TOKEN> \
  razerofficial/aikit:latest

Once inside the container, choose your preferred approach:

Option 1: Start with interactive guides

# Start Jupyter Lab for interactive guides (guides will be available at the outputted link)
jupyter lab --ip="0.0.0.0"

πŸ’‘ Tip: Explore the notebooks/ folder for step-by-step guides and examples!

OR

Option 2: Run a model directly

# Run a lightweight coding model
rzr-aikit model run deepseek-ai/deepseek-coder-1.3b-instruct

πŸ”¬ Advanced Mode

For production deployments and monitoring, enable the full stack with Docker Compose:

git clone https://github.com/razerofficial/aikit.git && cd aikit
mkdir -p $HOME/.cache/huggingface
export HUGGING_FACE_HUB_TOKEN=<YOUR_TOKEN>
docker compose -f docker_compose/docker-compose.yaml up -d --pull always

Available Services:

  • πŸ““ Jupyter Lab - Interactive notebooks with examples (http://localhost:8888)
  • πŸ“Š Grafana - GPU metrics, model performance, Ray cluster stats (http://localhost:3000)
  • πŸ’¬ Open WebUI - Chat interface for model testing (http://localhost:1919)
  • 🎯 Prometheus - Metrics collection (http://localhost:9090)

πŸ“š Documentation & Examples

πŸ“– Documentation

πŸ’‘ Interactive Examples


πŸ–₯️ Platform Support

Razer AIKit is optimized for NVIDIA accelerated computing platforms with support for both x86-64 and ARM64 architectures.

Workstations & Development

  • Razer Blade - High-performance gaming laptops with GeForce RTX 50 series, RTX 40 series, RTX 30 series, and RTX 20 series
  • NVIDIA RTX Professional Workstations - RTX PRO 6000 Blackwell, RTX 6000 Ada, RTX A series

Data Center & Enterprise

  • NVIDIA DGX Systems (x86-64 and ARM64)
    • NVIDIA GB10 (DGX Spark)
    • NVIDIA GB300, GB200
    • NVIDIA GH200, GH100
  • Data Center GPUs: B200, B300, H100, H200, A100, L4, L40, L40S

GPU Requirements

  • Minimum: NVIDIA GPU with Compute Capability 7.0 (Volta) or higher
  • Supported Architectures: Blackwell, Hopper, Ada Lovelace, Ampere, Turing, Volta
  • Detailed Information: GPU Compatibility Guide

πŸ† Contributors

We welcome contributions from the community! Special thanks to all our contributors who make this project possible.


πŸ“„ License & Acknowledgments

Licensed under Apache License 2.0

Additional Resources


Made with ❀️ by the Razer AI Team

🌟 Star us on GitHub

About

Razer AIKit is an AI development toolkit with fast LLM inferencing, fine-tuning, and multi-GPU scaling.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors