felix86

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 661 Open GitHub ↗

Run x86 and x86-64 games on RISC‑V Linux

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[中文](./README_CN.md) | [Website](https://felix86.com) | **[Discord](https://discord.gg/TgBxgFwByU)**

# felix86

felix86 is a Linux userspace emulator that allows you to run x86 and x86-64 programs on RISC-V processors

## Getting started

### Ubuntu/Debian/Bianbu and maybe others
Run the following command:

```bash
bash <(curl -fsSL https://install.felix86.com)
```

This command downloads and runs a script which installs felix86 and a rootfs of your choice.

Documentation for developers and users can be found here: https://felix86.com/docs

Feel free to join our **Discord server**: [https://discord.felix86.com](https://discord.felix86.com)

## Features
- Just-in-Time (JIT) recompiler
- Uses the RISC-V Vector Extension for SIMD extensions up to AVX2
- Supports RVA23 hardware and many optional extensions
- Uses the host libraries in some cases for improved performance

## Compatibility
A compatibility list can be found here: https://felix86.com/compat

## Dependencies
felix86 relies on several great projects:

- [FEX](https://github.com/FEX-Emu/FEX)'s comprehensive unit test suite
- [Biscuit](https://github.com/lioncash/biscuit) for RISC-V code emission
- [Zydis](https://github.com/zyantific/zydis) for decoding and disassembly
- [Catch2](https://github.com/catchorg/Catch2) for unit testing
- [fmt](https://github.com/fmtlib/fmt) for string formatting
- [nlohmann/json](https://github.com/nlohmann/json) for JSON parsing
- [tomlc17](https://github.com/cktan/tomlc17) for TOML parsing
- [berkeley-softfloat-3](https://github.com/ucb-bar/berkeley-softfloat-3) for x87 80-bit float emulation

We also use binary tests from other projects to verify correct behavior and prevent regressions.    
[You can find these tests here.](https://github.com/felix86-emu/binary_tests)

## Why?
felix86 was started for several reasons, including:

- Gaining a deeper understanding of x86-64, RISC-V, Linux, and high-level emulation
- Exploring optimizing compilers and JITs (SSA, register allocation, optimization passes, etc.)
- To learn more about low level details, such as signals, syscalls, program loading
- Taking on a fun and challenging project

## Also Check Out

- [Panda3DS](https://github.com/wheremyfoodat/Panda3DS), a 3DS emulator for Windows, macOS, Linux, and Android
- [shadPS4](https://github.com/shadps4-emu/shadPS4), one of the leading PS4 emulators
- [ChonkyStation3](https://github.com/liuk7071/ChonkyStation3), experimental HLE PS3 emulator for Windows, MacOS and Linux

felix86

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README