Home

BiuBiuBiu

English | 中文 | Русский | Español | Português | 繁體中文 | Deutsch

A stream-oriented programming language implemented in Rust — an interpreter plus a source-embedding compiler. Every operation is a request that may be refused (res / cause / ref); programs are built from composable streams.

• Streams: Unistream, Comstream, Remstream, Objstream, Threadstream, Timestream, IOStream, ... — signature streams, forked implementations, classes-as-streams.
• Typed smart references: 28 reference types (permissions r/w/m/ rw/rm/wm/rwm × follows u/f/a/t). Read with get p, write with p = v, move the pointer with p++.
• need assumptions: on-demand provider bundling from src/ + utils/ + dependencies; project manifests (package.toml) with git/HTTP/local deps.
• Annotations: @unfork (stream cannot be forked), @onlyread (no write methods may be called), @read / @write (declare a method read/write).
• Packaging: .img (custom raw image, stores permissions) and .zip (native STORE writer — no external tools needed).
• Cross-platform: Linux, macOS and Windows (experimental) binaries built built with Rust (wasm32/LLVM); cooperative threads (ucontext / Win32 fibers).

Quick start

cd rust && cargo build --release -p bbb-cli   # build → target/release/bbb

bbb examples/01-hello.bio   # run an example (interpreter)
bbb llvm examples/17-llvm.bio  # compile to a native binary via LLVM

A prebuilt interpreter is also available at bin/bio (legacy C build).

Project build & package

bio init <name>             # create a project skeleton
bio build [dir] -s          # build → standalone executable
bio build [dir] -m          # build → .img package (app + platform CLI + libs)
bio build [dir] -m out.zip  # build → .zip package
bio run [dir]               # run a project

Packaging

bio pack <out.img|.zip> [--entry NAME] <files...>
bio unpack <pkg> [dir]
bio run pkg.img | pkg.zip   # run a packaged entry

• .img — custom BIOIMG1 raw image: no compression, fully seekable, stores file permissions (executables keep their executable bit).
• .zip — standard zip, written/read natively (STORE method); falls back to the system unzip for legacy deflate archives.

Platform support

Platform	Status
Linux (x86-64, aarch64)	✅ Fully supported
macOS (Intel)	⚠️ Works (ucontext deprecation warnings)
macOS (Apple Silicon)	⚠️ Prebuilt binaries work; source builds hit Apple ucontext bugs
Windows (x86-32/64, arm64)	⚠️ Experimental (fiber backend + LoadLibrary shim)

Tutorials

Learn BiuBiuBiu step by step — available in English, 中文, Русский:

• Beginner — first steps: concepts, types, requests, control flow.
• Intermediate — real usage: streams, classes, need, files, threads, projects.
• Advanced — masterclass: smart references, native libraries, memory, cross-platform, a full project.
• Language Reference — the complete grammar, in order, with stories & proverbs.
• BR Model — the formal Bio Running execution model (requests, arenas, booths).
• BTM Model — the formal Bio Task Manager model (threads, tasks, scheduling).

Links

• Build & Run — building, running, compiling, projects
• Packaging — .img / .zip formats, entry points, cross-platform trees
• Main README: https://github.com/Bio-Studio/Bio.lang
• Releases: https://github.com/Bio-Studio/Bio.lang/releases
• License: MIT