--- /dev/null
+Bare Metal BlackBox
+--------------------
+
+BlackBox Component Builder ported to bare x86 PC and runs without any host os.
+
+Project goals:
+- Make BlackBox to be fully independent environment;
+- Make BlackBox easy to port to other os;
+- Learn BlackBox internals and possibly port it to new architectures.
+
+Building
+-------------------
+
+Requirements:
+* GNU/Linux or any other *nix
+* BlackBox 1.7.1
+* GNU Binutils
+* Wine
+* Qemu
+
+Firstly copy files from this repo to clean BlackBox 1.7.1 environment. (http://blackboxframework.org/stable/blackbox-1.7.1.zip)
+Than just sequentially execute commanders from Docu486/Build-Tool.odc.
+
+Known Issues
+-------------------
+
+Currently BMBB on early alpha stage. It can boot on hardware that do not require to enable A20 Line and requires at least 16M Ram.
+Kernel implements everything exept coroutine supporting. Implemented only keyboard and speaker drivers (see Host subsystem). That all.
+Currently graphics not supported, but implemented simple textmode Shell based on StdInterpreter. You can call Init.WinterWrapUp and enjoy music on you pc speaker. :)