-
Notifications
You must be signed in to change notification settings - Fork 141
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
24 changed files
with
199 additions
and
766 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -18,7 +18,7 @@ An important goal is to make the simulator user-friendly through a modern user i | |
Please join our <a href="https://discord.gg/7bjyZdXXQ2" target="_blank">Discord server</a> as a place for discussions, new developments and feedback around ALIEN and artificial life in general. | ||
</p> | ||
|
||
# Main features | ||
# ⚡ Main features | ||
### Physics and graphics engine | ||
- Particles for simulating soft and rigid body mechanics, fluids, heat dissipation, damage, adhesion etc. | ||
- Real-time user interactions with running simulations | ||
|
@@ -47,16 +47,15 @@ https://user-images.githubusercontent.com/73127001/229569056-0db6562b-0147-43c8- | |
- Download and upload simulation files | ||
- Upvote simulations by giving stars | ||
|
||
# But for what is this useful? | ||
# ❓ But for what is this useful | ||
- A first attempt to answer: Feed your curiosity by watching evolution at work! As soon as self-replicating machines come into play and mutations are turned on, the simulation itself does everything. | ||
- Perhaps the most honest answer: Fun! It is almost like a game with a pretty fast and realistic physics engine. You can make hundreds of thousands of machines accelerate and destroy with the mouse cursor. It feels like playing god in your own universe with your own rules. Different render styles and a visual editor offer fascinating insights into the events. There are a lot of videos on the [YouTube channel](https://youtube.com/channel/UCtotfE3yvG0wwAZ4bDfPGYw) for illustration. | ||
- A more academic answer: A tool to tackle fundamental questions of how complexity or life-like structure may arise from simple components. How do entire ecosystems adapt to environmental changes and find a new equilibrium? How to find conditions that allow open-ended evolution? | ||
- A tool for generative art: Evolution is a creative force that leads to ever new forms and behaviors. | ||
|
||
# Documentation | ||
# 📘 Documentation | ||
A documentation for the previous major version, which introduces the reader to the simulator with tutorial-like articles, can be found at [alien-project.gitbook.io/docs](https://alien-project.gitbook.io/docs). Please notice that many of the information therein are no longer up to date. | ||
|
||
A new documentation is currently under construction. However a lot of useful information is provided in the program itself via help windows and tooltips. | ||
The latest version includes a brief documentation and user guidance in the program itself via help windows and tooltips. | ||
|
||
Further information and artwork: | ||
* [Website](https://alien-project.org) | ||
|
@@ -65,15 +64,15 @@ Further information and artwork: | |
* [Reddit](https://www.reddit.com/r/AlienProject) | ||
* [Discord](https://discord.gg/7bjyZdXXQ2) | ||
|
||
# Minimal system requirements | ||
# 🖥️ Minimal system requirements | ||
An Nvidia graphics card with compute capability 6.0 or higher is needed. Please check [https://en.wikipedia.org/wiki/CUDA#GPUs_supported](https://en.wikipedia.org/wiki/CUDA#GPUs_supported). | ||
|
||
# Installer | ||
An installer for Windows: [download link](https://alien-project.org/media/files/alien-installer.zip) (Updated: 2023-09-07) | ||
# 💽 Installer | ||
Installer for Windows: [alien-installer.msi](https://alien-project.org/media/files/alien-installer.msi) (Updated: 2023-09-14) | ||
|
||
In the case that the program crashes for an unknown reason, please refer to the troubleshooting section in [alien-project.org/downloads.html](https://alien-project.org/downloads.html). | ||
|
||
# How to build the sources | ||
# 🔨 How to build the sources | ||
The build process is mostly automated using the cross-platform CMake build system and the vcpkg package manager, which is included as a Git submodule. | ||
|
||
### Getting the sources | ||
|
@@ -95,7 +94,26 @@ cmake --build . --config Release -j8 | |
``` | ||
If everything goes well, the ALIEN executable can be found under the build directory in `./alien` or `.\Release\alien.exe` depending on the used toolchain and platform. | ||
|
||
# Contributing to the project | ||
# 🌌 Screenshots | ||
#### Different plant-like populations around a radiation source | ||
![Screenshot1](https://user-images.githubusercontent.com/73127001/229311601-839649a6-c60c-4723-99b3-26086e3e4340.jpg) | ||
|
||
<h1 align="center"></h1> | ||
|
||
#### Close-up of different types of organisms so that their cell networks can be seen | ||
![Screenshot2](https://user-images.githubusercontent.com/73127001/229311604-3ee433d4-7dd8-46e2-b3e6-489eaffbda7b.jpg) | ||
|
||
<h1 align="center"></h1> | ||
|
||
#### Different swarms attacking an ecosystem | ||
![Screenshot3](https://user-images.githubusercontent.com/73127001/229311606-2f590bfb-71a8-4f71-8ff7-7013de9d7496.jpg) | ||
|
||
<h1 align="center"></h1> | ||
|
||
#### Genome editor | ||
![Screenshot3b](https://user-images.githubusercontent.com/73127001/229313813-c9ce70e2-d61f-4745-b64f-ada0b6758901.jpg) | ||
|
||
# 🧩 Contributing to the project | ||
Contributions to the project are very welcome. The most convenient way is to communicate via [GitHub Issues](https://github.com/chrxh/alien/issues), [Pull requests](https://github.com/chrxh/alien/pulls) or the [Discussion forum](https://github.com/chrxh/alien/discussions) depending on the subject. For example, it could be | ||
- Providing new content (simulation or genome files) | ||
- Producing or sharing media files | ||
|
@@ -105,7 +123,14 @@ Contributions to the project are very welcome. The most convenient way is to com | |
|
||
A short architectural overview of the source code can be found in the [documentation](https://alien-project.gitbook.io/docs/under-the-hood). | ||
|
||
# Dependency list | ||
# 💎 Credits and dependencies | ||
|
||
ALIEN has been initiated, mainly developed and maintained by [Christian Heinemann](mailto:[email protected]). Thanks to all the others who contributed to this repository: | ||
- [tlemo](https://github.com/tlemo) | ||
- [mpersano](https://github.com/mpersano) | ||
- [dguerizec](https://github.com/dguerizec) | ||
|
||
The following external libraries are used: | ||
- [CUDA Toolkit](https://developer.nvidia.com/cuda-toolkit) | ||
- [Dear ImGui](https://github.com/ocornut/imgui) | ||
- [ImPlot](https://github.com/epezent/implot) | ||
|
@@ -120,29 +145,14 @@ A short architectural overview of the source code can be found in the [documenta | |
- [zstr](https://github.com/mateidavid/zstr) | ||
- [OpenSSL](https://github.com/openssl/openssl) | ||
- [cpp-httplib](https://github.com/yhirose/cpp-httplib) | ||
- [IconFontCppHeaders](https://github.com/juliettef/IconFontCppHeaders) | ||
- [googletest](https://github.com/google/googletest) | ||
- [vcpkg](https://vcpkg.io/en/index.html) | ||
- [WinReg](https://github.com/GiovanniDicanio/WinReg) | ||
|
||
# Screenshots | ||
#### Different plant-like populations around a radiation source | ||
![Screenshot1](https://user-images.githubusercontent.com/73127001/229311601-839649a6-c60c-4723-99b3-26086e3e4340.jpg) | ||
|
||
<h1 align="center"></h1> | ||
|
||
#### Close-up of different types of organisms so that their cell networks can be seen | ||
![Screenshot2](https://user-images.githubusercontent.com/73127001/229311604-3ee433d4-7dd8-46e2-b3e6-489eaffbda7b.jpg) | ||
|
||
<h1 align="center"></h1> | ||
|
||
#### Different swarms attacking an ecosystem | ||
![Screenshot3](https://user-images.githubusercontent.com/73127001/229311606-2f590bfb-71a8-4f71-8ff7-7013de9d7496.jpg) | ||
|
||
<h1 align="center"></h1> | ||
|
||
#### Genome editor | ||
![Screenshot3b](https://user-images.githubusercontent.com/73127001/229313813-c9ce70e2-d61f-4745-b64f-ada0b6758901.jpg) | ||
Free icons and icon font: | ||
- [IconFontCppHeaders](https://github.com/juliettef/IconFontCppHeaders) | ||
- [Iconduck](https://iconduck.com) (Noto Emoji by Google, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt)) | ||
- [Iconfinder](https://www.iconfinder.com) (Bogdan Rosu Creative, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0)) | ||
|
||
# License | ||
ALIEN is licensed under the [GPLv3](LICENSE). | ||
# 🧾 License | ||
ALIEN is licensed under the [BSD 3-Clause](LICENSE) license. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.