Optimal Living Systems — Documentation¶
OLS is a mutual aid nonprofit building open-source AI infrastructure for communities. This site is the central knowledge base for everyone who works on, collaborates with, or wants to understand the OLS ecosystem — from new volunteers joining their first sprint to external organizations exploring our published frameworks.
Find what you need in 30 seconds¶
Welcome. Start here — in this order:
- Read the mission and values — understand what we are building and why
- Read your role profile — understand what your contribution looks like
- Complete the onboarding guide — set up your tools and make your first contribution
New volunteer? Start with the onboarding guide.
It takes about two hours and gets you from zero to your first contribution.
Jump directly to what you need:
| I need to... | Go to... |
|---|---|
| Work on a pipeline | Infrastructure → Pipelines |
| Work on a project (AI Lab, Research Lab) | Projects |
| Find a process or how-to guide | Guides |
| Look up a tool or system | Infrastructure → Tools |
| Find a team member or role | Team |
| Review or log a decision | Decisions |
| Check the roadmap | Roadmap |
| Add or edit a doc | How to contribute |
OLS publishes our frameworks, research, and methodology publicly. Good starting points:
- What OLS is building — mission, vision, and projects overview
- AI Lab — what the AI Lab does and why
- Research Lab — open science research
- How to collaborate with OLS — partnership and adoption
What OLS is building¶
| Project | What it does | Status |
|---|---|---|
| HBoK | Holistic personal knowledge representation with privacy sovereignty | Active |
| OVNN | Multi-output value scoring across ecological and psychological dimensions | Active |
| CommunityLLM | Politically neutral LLM for real-time community meeting participation | Active |
| DirectDemocracyLLM | Federated AI architecture for communities up to 15,000 | Active |
| SociologyLLM | Fine-tuned sociological reasoning model | Active |
| GNO | 31-domain planetary-scale human needs ontology | Active |
| DeepFlo | 7-stage autonomous sociology research pipeline | Active |
| One World CSC | Peer recovery support center | Active |
How this site is organized¶
The navigation tabs at the top route to these sections:
| Tab | What lives here |
|---|---|
| Organization | Mission, values, governance, org-wide policies |
| Projects | AI Lab, Research Lab, and all active projects |
| Infrastructure | Tools, platforms, pipelines, and systems |
| Guides | Onboarding, how-to guides, and processes |
| Roadmap | Strategic plan and quarterly milestones |
| Team | Directory, roles, and how we work |
If you cannot find what you need through navigation, use the search bar (top right) — it indexes every page on the site.
Contributing to this documentation¶
Every page has a named owner responsible for keeping it accurate. If you find something wrong or missing:
- Fix it yourself — follow the contribution guide
- Open an issue — create a GitHub issue with the label
documentation - Ask for help — post in
#docs-help
| Maintained by | OLS Documentation Team |
| Platform | MkDocs with Material theme |
| Repository | github.com/optimal-living-systems/docs |
| License | Apache 2.0 |