# AromiaOS

**Repository Path**: openOHO/aromia-os

## Basic Information

- **Project Name**: AromiaOS
- **Description**: 主仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AromiaOS

> Brighter. Lighter. Yours.

A modern hybrid kernel operating system designed for full-stack convergence across consumer, embedded, and server platforms.

## Brand

- **Name**: AromiaOS
- **Version**: Saffron (鲁黄金)
- **Slogan**: Brighter. Lighter. Yours.
- **Color**: Golden / Saffron Yellow (#F4C430)

## Features

- **Hybrid Kernel**: Windows NT-style architecture with microkernel core
- **Multi-Platform**: x86_64, AArch64, RISC-V 64 support
- **Modern Languages**: Rust + Zig implementation
- **Custom Display Protocol**: Integrated compositor with Vulkan/Metal support
- **Security**: Capability + ACL hybrid model with sandboxing
- **Performance**: EDF real-time scheduling, async I/O, zero-copy

## Architecture

```
┌─────────────────────────────────────────────────────────┐
│                   Userspace                             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌───────────────┐ │
│  │ Desktop │ │ Shell   │ │ Apps    │ │ Services      │ │
│  │ Env     │ │         │ │         │ │ (Network/Audio)│ │
│  └────┬────┘ └────┬────┘ └────┬────┘ └───────┬───────┘ │
│       │           │           │               │         │
│  ┌────▼───────────▼───────────▼───────────────▼───────┐ │
│  │               Libc / System Call Interface         │ │
│  └───────────────────────────┬───────────────────────┘ │
└──────────────────────────────┼──────────────────────────┘
                               │ System Calls
┌──────────────────────────────▼──────────────────────────┐
│                     Kernel Space                       │
│  ┌─────────────────────────────────────────────────┐   │
│  │              Microkernel Core                   │   │
│  │  - Scheduler (EDF)      - IPC                   │   │
│  │  - Memory Mgmt          - Security              │   │
│  │  - Process Mgmt         - Timer                │   │
│  │  - Virtual Filesystem   - Drivers Interface    │   │
│  └─────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────┐   │
│  │              User-mode Services                 │   │
│  │  - Network Stack        - Audio System          │   │
│  │  - Display Server       - File System Drivers   │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘
```

## Directory Structure

```
aromiaos/
├── kernel/          # Kernel source code
│   ├── core/        # Core kernel components
│   ├── arch/        # Architecture-common code
│   ├── x86_64/      # x86_64-specific code
│   ├── aarch64/     # AArch64-specific code
│   ├── riscv64/     # RISC-V 64-specific code
│   ├── mm/          # Memory management
│   ├── fs/          # File system
│   ├── net/         # Network stack
│   ├── sched/       # Process scheduler
│   ├── ipc/         # Inter-process communication
│   ├── drivers/     # Device drivers
│   └── util/        # Utility functions
├── userspace/       # Userspace applications and libraries
│   ├── libc/        # C standard library
│   ├── init/        # Init process
│   ├── shell/       # Command shell
│   └── tools/       # System tools
├── docs/            # Documentation
├── tools/           # Build tools and scripts
├── configs/         # Configuration files
├── tests/           # Test suites
└── third_party/     # Third-party dependencies
```

## Requirements

- LLVM/Clang (latest)
- Rust (nightly)
- Zig (latest)
- QEMU (for testing)

## Build

```bash
# Build the kernel (x86_64)
./build.sh x86_64

# Build for AArch64
./build.sh aarch64

# Build for RISC-V 64
./build.sh riscv64
```

## Run

```bash
# Run in QEMU (x86_64)
./run.sh x86_64

# Run in QEMU (AArch64)
./run.sh aarch64
```

## Documentation

- [Design Specification](docs/spec.md)
- [Kernel Architecture](docs/kernel_arch.md)
- [Userspace Guide](docs/userspace.md)

## License

Closed source.

## Community

- [Discourse Forum](https://community.aromiaos.org)

---

**Built with passion for better computing.**