summaryrefslogtreecommitdiffhomepage
path: root/README.md
blob: b7ee3baba7be5d00f8f3d0f53fb7aa9101f1fa4d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
<!-- Read Me of NeKernel Sources -->

<div align="center">
  <h1>
    <b>The Ne.org System.</b>
  </h1>
  <p>
    <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-blue.svg" alt="License"></a>
  </p>
</div>

## Primers:

The primers are available at:

- https://primer.src.nekernel.org
- https://primer.nectar.nekernel.org

## Love the work?

Love our work? Give us a star!

![GitHub Repo stars](https://img.shields.io/github/stars/ne-foss-org/ne_system)

## Description:

This is the system distribution of Ne.org. 

Designed the contain all of the stack together. 

It facilities are provided to build compiler toolchains as well.

## Getting Started:

Please clone the repository using Git:

```sh
git clone --recurse-submodules -j8 git@github.com:ne-foss-org/ne_system.git
```

And have a look at the wiki, docs, and primers. They have valuable resources to get started.

## Rationale:

There is three main reasons for this repository's existence:

- Hold the codebase in a single repository.
- Easier path resolutions based on a virtual root path, i.e (../kernel -> /src/kernel)
- Easier cycles and vetting for Ne.org releases.

## Building:

You will need:

- `nebuild` for the kernel build system.
- `MinGW` or `Clang` depending on the HAL/target ISA.
- `GNU CoreUtils` for the core compiler utilities.

Please follow the the tutorials in `/src/reference` to get started.

## Community:

We have a [discord](https://discord.gg/uD76Qweght), join us! [https://discord.gg/uD76Qweght](https://discord.gg/uD76Qweght)

###### Copyright 2025-2026, Amlal El Mahrouss & Ne.org Authors. Licensed under Apache 2.0.