Skip to content

Latest commit

 

History

History
49 lines (29 loc) · 2.77 KB

File metadata and controls

49 lines (29 loc) · 2.77 KB

Contributing to Dosidicus 🦑

Dosidicus isn't just a repository; it’s an open-ended experiment in transparent artificial life. We are building a world where cognition isn't a black box, but a visible, hackable structure. Whether you are a neuro-enthusiast, a Python wizard, or a digital explorer, there is a place for you in the sandbox.

🧠 1. Evolve the Core (src/)

The STRINg engine is the beating heart of the project. We’ve avoided heavy frameworks like TensorFlow to keep things "bare metal" and interpretable.

The Challenge: Optimize neural algorithms, refine Hebbian plasticity logic, or enhance the real-time UI.

Goal: Make the simulation faster and the neural dynamics more expressive.

🧩 2. Architect New Realities (plugins/)

Dosidicus is designed to be modular. Our plugin system allows you to inject new logic without touching the core engine.

The Challenge: Create a new plugin folder with a plugin.txt descriptor.

Ideas: Environmental stressors, advanced "Achievement" triggers, or even a Twitch-integrated "Chat-controlled Evolution."

🧬 3. Map the Connectome (custom_brains/)

Help us build a library of diverse neural starting points. By contributing JSON templates to custom_brains/, you define the "DNA" that users experiment with.

The Challenge: Design a unique neural layout—perhaps a highly recurrent "memory loop" or a sensory-heavy "predator" build.

📂 4. Share Your Specimens (example_squids/)

In this sandbox, Structure + Experience = Behavior. No two squids are identical.

The Challenge: Export your .json save files and share them. Did your squid develop a strange obsession with a specific corner of the map? Did it grow a massive neural cluster after a specific training session?

Action: Submit your most interesting "trained" squids as examples for others to study.

🌍 5. Bridge the Language Gap (translations/)

We want "visible minds" to be accessible to everyone.

The Challenge: Add a new language file (e.g., fr.py, jp.py) to the translations/ directory. Help us ensure that concepts like Neurogenesis and Activation Patterns translate clearly across cultures.

🛠️ 6. Documentation & Educational Outreach

If a newcomer can’t understand how to "read" a squid’s mind, the transparency is lost.

The Challenge: Improve docstrings, write "Field Guides" for new users, or record a video of a specific behavioral emergence.

Goal: Turn complex neuroscience concepts into playable tutorials.

🚀 How to Get Started

Check the "Ahead" Forks: See what the community is already building in the Network Graph.

Open an Issue: Have a wild idea for a new neuron type? Let's discuss it first!

Submit a PR: We welcome all PRs, from single-typo fixes to massive engine overhauls.

Every commit is a mutation. Every contribution helps the system grow.