QCore - AI Native Rust Agent Runtime

中文 | English

QCore is an AI Native Rust Agent runtime that provides a unified abstraction layer for Large Language Models and a complete agent execution environment. Built from the ground up with AI-first principles, QCore enables developers to build intelligent, autonomous agents with native Rust performance and safety.

✨ What is AI Native?

QCore is designed with AI as a first-class citizen, and is itself built by AI:

• AI-Generated Codebase: The entire project is generated and evolved through AI collaboration, demonstrating the power of AI-assisted development
• Unified LLM Interface: Abstract away provider differences (Anthropic, Qwen, Kimi) with a single, consistent API
• Streaming-First Architecture: Built-in support for real-time streaming responses
• Tool-Augmented Agents: Native tool system allowing agents to interact with the environment
• Event-Driven Runtime: Dual-layer event loop for efficient agent execution
• Type-Safe Tool Definitions: Leverage Rust's type system for safe tool interactions

QCore is not just a runtime for AI agents—it's a testament to AI's capability in building production-grade systems.

🎯 Project Status

✅ Core Features Completed

• LLM API abstraction layer (supports Anthropic Claude, Qwen, Kimi)
• Agent runtime with dual-layer event loop
• Tool system (Read, Write, Bash)
• Streaming response handling
• CLI command-line tool
• Configuration file management

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/yourusername/qcore.git
cd qcore

# Build the project
cargo build --release

# Run the CLI
./target/release/qcore

Configuration

QCore uses a dual-layer configuration system: API keys and model configurations are stored separately.

Environment Variables

Configure API keys via environment variables (higher priority than config files):

# Anthropic Claude
export ANTHROPIC_API_KEY="your-claude-api-key"


# Qwen
export QWEN_API_KEY="your-qwen-api-key"

# Kimi
export KIMI_API_KEY="your-kimi-api-key"

Configuration File

Create ~/.qcore/config.json to store API keys:

{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "your-claude-api-key"
      },
      }
    }
  }
}

See config.example.json for a complete example.

📚 Documentation

• Architecture - System architecture and design
• Contributing Guide - How to contribute
• API Documentation - API reference

Module Documentation

• qcore-ai - LLM API abstraction layer
• qcore-agent - Agent runtime core
• qcore-cli - Command-line interface

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                      qcore-cli                          │
│                   (CLI Interface)                       │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│                    qcore-agent                          │
│              (Agent Runtime Core)                       │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐ │
│  │ Agent Loop   │  │ Tool System  │  │ Event Queue  │ │
│  └──────────────┘  └──────────────┘  └──────────────┘ │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│                     qcore-ai                            │
│              (LLM API Abstraction)                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────┐ │
│  │Anthropic │  │  Qwen    │  │  Kimi  │ │
│  └──────────┘  └──────────┘  └──────────┘  └────────┘ │
└─────────────────────────────────────────────────────────┘

🤝 Contributing

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

📄 License

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

🔗 Links

• Documentation
• Issue Tracker
• Changelog