Saltar al contenido

Código abierto / Un lugar para ti

Un sistema desde cero. Mejor contigo.

No necesitas saber escribir un kernel para participar. Prueba AriCodeOS, haz una pregunta, comparte una idea o aporta código. Aquí hay sitio para tu curiosidad.

Una pregunta también es una aportación.

Cuatro formas de ayudar a crecer a AriCodeOS: probarlo, compartirlo, preguntar y aportar código. Todas conectan con el mismo proyecto de código abierto.

Pruébalo

Tu primer ari> empieza aquí

Elige la forma que mejor te encaje. Las guías y los comandos están aquí para cuando los necesites.

En Docker

Un solo comando arranca la última versión desde GitHub. QEMU se ejecuta dentro del contenedor y el shell ari> aparece en tu terminal, sin compilar nada.

En tu propio equipo

Prueba la imagen USB en un equipo que no uses. Consulta la guía de hardware antes de preparar el pendrive.

Desde el código

Compílalo con cargo xtask y ejecuta tú mismo todas las pruebas en QEMU.

¿Cómo lo arranco con Docker?
Docker
docker run --rm -it ghcr.io/aricodelabs/aricodeos
# en el prompt ari>: help, ps, mem, net, dns www.aricodeos.org, http https://www.aricodeos.org/
# salir: Ctrl-A X

# Linux con KVM, más rápido:
docker run --rm -it --device /dev/kvm ghcr.io/aricodelabs/aricodeos \
  -accel kvm -machine kernel-irqchip=split

Cuéntanoslo

Cada máquina le enseña algo al sistema

Envía un informe de hardware aunque se pare en la primera línea: saber dónde se para es justo lo que ayuda. Solo necesitas una cuenta gratuita de GitHub, que nos permite responderte y reconocer tu aportación.

Sigue cerca

¿Hoy solo estás curioseando? También cuenta.

Guarda el proyecto con una estrella en GitHub, sigue las nuevas versiones o pásale el enlace a alguien a quien le guste construir cosas. Puedes volver cuando te apetezca dar el siguiente paso.

Aporta código

Tu primera aportación empieza con una conversación

Explora las issues con las etiquetas good first issue o help wanted y lee la guía de contribución. Si no sabes por dónde empezar, pregunta en Discussions. Los pull requests van a develop, con sus pruebas; quienes contribuyen aparecen en AUTHORS.md.

  • Haz un fork del repositorio y crea una rama desde develop: feature/… o fix/…
  • Ejecuta cargo xtask check y cargo xtask test antes del pull request
  • Añade un ADR en docs/decisions/ si cambias la arquitectura
  • Sé amable: el código de conducta rige en todas partes

Detrás de cada aportación hay una persona

Gracias por la curiosidad.

AriCodeOS empezó con una persona y una idea. Tus pruebas, preguntas y aportaciones pueden ayudar a dar forma a lo que viene. Nos encantará leerte.

Licencia

Úsalo, construye encima, cítalo

AriCodeOS tiene licencia Apache-2.0: puedes usarlo, modificarlo y redistribuirlo. A cambio, conserva el fichero NOTICE y di que tu trabajo está «basado en AriCodeOS de Edwin F. Veliz Jaramillo (lynxcraft)».