README
Decentralized Sustainability + Local AI Infrastructure Vault
A comprehensive, open-source knowledge base for building resilient communities through renewable energy, local LLM systems, DIY infrastructure, and regenerative food & water systems.
π± What This Is
This is not a blog, tutorial, or finished textbook. It's a living knowledge system designed for:
- Builders: People implementing systems in the real world
- Communities: Groups organizing for mutual aid and resilience
- Learners: Students building deep fluency in STEM and systems thinking
- Teachers: Facilitators sharing knowledge within communities
It combines:
- Pragmatic, immediately-actionable guides (bill of materials, step-by-step builds)
- Theoretical foundations (understand the why, not just the how)
- Community governance frameworks (how to organize and make decisions)
- Failure analysis (what didn't work and why)
- Interconnected concepts (nothing is isolated; everything links to everything)
πΊοΈ How to Navigate
First Time Here?
- Start: 00-MOC/00-VAULT-HOME
- Read: 01-Philosophy/01-CORE-VALUES (5 min)
- Pick your entry path:
- Energy-focused: β 07-Energy-Systems/07-ENERGY-MOC
- AI/Computing-focused: β 04-Local-LLM-Systems/04-LOCAL-LLM-MOC
- Community-focused: β 09-Community-Building/09-COMMUNITY-MOC
- Food & Water-focused: β 08-Water-Food/08-FOOD-WATER-MOC
- DIY/Fabrication-focused: β 03-DIY-Infrastructure/03-DIY-MOC
Looking for Something Specific?
Use Obsidian's Search (Cmd/Ctrl+F) or Graph View to find related topics.
Key search terms:
- System name: "solar", "LLM", "aquaponics", "consensus"
- Problem: "failure", "cold joint", "pH crash", "firmware"
- Action: "setup", "install", "troubleshoot", "calculate"
Want to Deep Dive?
Each folder has a MOC (Map of Contents):
00-MOC/β Hub pages for navigation07-Energy-Systems/07-ENERGY-MOCβ Everything about energy04-Local-LLM-Systems/04-LOCAL-LLM-MOCβ LLM and AI infrastructure- (etc.)
π Folder Structure
obsidian-vault/
βββ 00-MOC/ β Navigation hubs
β βββ 00-VAULT-HOME β Start here
βββ 01-Philosophy/ β Values, frameworks, theory
βββ 02-Solarpunk-Ecopunk/ β Narratives and inspiration
βββ 03-DIY-Infrastructure/ β Electronics, PCB, fabrication
βββ 04-Local-LLM-Systems/ β Local AI, models, RAG
βββ 05-STEM-Core/ β Math, physics, chemistry
βββ 06-Materials-Sourcing/ β Vendors, cost optimization
βββ 07-Energy-Systems/ β Solar, wind, battery, microgrids
βββ 08-Water-Food/ β Growing, preservation, treatment
βββ 09-Community-Building/ β Governance, skill-sharing, organizing
βββ 10-Projects/ β Active builds, lessons learned
βββ 11-Templates/ β Reusable note structures
βββ 12-Resources/ β External links, references
Linking convention:
- Topic-Name = link to a note
- Folder/Topic-Name = link with folder path
- Cross-links are everywhere (use Graph View to see the web)
π» How to Use This Vault
Option 1: Read in Obsidian (Recommended)
- Download the vault folder
- Open in Obsidian (File β Open Vault β select folder)
- Enable plugins:
- Graph View (built-in) β see knowledge structure
- Backlinks (built-in) β navigate relationships
- Dataview (community) β optional, for queries
- Templater (community) β optional, for auto-templates
Option 2: Read on GitHub / Web
- All notes are plain markdown
- Open
00-MOC/00-VAULT-HOME.mdas your entry point - Links will work on GitHub
Option 3: Export & Print (Partial)
- Select folder β Export as PDF
- Good for offline reference
βοΈ How to Adapt This Vault
This vault is a template, not gospel. Customize it for your context:
Add Your Own Projects
- Copy 11-Templates/TEMPLATES-INDEX β Project-Template
- Rename with date:
2024-02-15-PROJECT-My-Build - Place in
10-Projects/folder - Link from
10-Projects/10-PROJECTS-MOC - Document as you go (photos, challenges, lessons)
Adapt to Your Bioregion
- Climate: Modify plant species, solar resource, heating needs
- Vendors: Replace sourcing links with local suppliers
- Language/Culture: Translate, localize governance frameworks
- Resources: Add local experts, organizations, community contacts
Create Specialized Sections
Add folders for:
13-Local-Vendors/β Your region's supplier list14-Bioregion-Data/β Climate, water, soil data specific to you15-Legal-Compliance/β Local building codes, regulations16-Case-Studies/β Projects in your area
π€ Contributing Back
This vault is stronger with community input.
Ways to Contribute
Document a project:
- Build something? 11-Templates/Project-Template + push to GitHub
- Share: failures are as valuable as wins
Improve existing notes:
- Found an error? Clarify and propose fix
- Tested a method? Add your results to existing note
- Found better vendor? Update 06-SOURCING-MOC
Add resources:
- Found a great tutorial? Link it with context
- Have a paper/book? Summarize key findings
- Know a local expert? Add to Community-Building section
Translate or localize:
- Adapt for your language/region
- Create regional variant (e.g.,
07-Energy-Systems-AMEA/) - Local vendors, climate-specific guidance
How to Submit
Via GitHub (if you know git):
- Fork repository
- Create branch:
feature/your-improvement - Commit changes
- Open Pull Request with description
Via Issue/Discussion:
- Describe improvement or addition
- Maintainer incorporates or helps refine
Via Email/Contact:
- Share document or note
- We integrate and credit you
π How to Use This for Learning
Study Path 1: Energy Systems (12 weeks)
- Week 1-2: 05-STEM-Core/05-STEM-MOC (fundamentals)
- Week 3-4: 07-Energy-Systems/07-ENERGY-MOC (theory)
- Week 5-6: System design (pick one: solar, wind, hydro)
- Week 7-10: Build a system (hands-on, real hardware)
- Week 11-12: Document + iterate
Outcome: Can design and implement a small renewable system
Study Path 2: Local LLM Systems (8 weeks)
- Week 1: 04-LOCAL-LLM-MOC (overview)
- Week 2-3: 04-LOCAL-LLM-Systems/Ollama-Setup + LLM-Fundamentals
- Week 4-5: Build RAG system with real data (04-LOCAL-LLM-Systems/RAG-Architecture)
- Week 6-7: Fine-tune or integrate with other systems
- Week 8: Deploy + document
Outcome: Can run and customize local LLM systems
Study Path 3: Community Organization (Ongoing)
- Read: 01-Philosophy, 09-COMMUNITY-MOC
- Practice: Lead facilitation, manage conflicts, document decisions
- Teaching: Skill-shares and community workshops
- Reflection: Document learnings in 10-Projects
Outcome: Can organize and sustain a community group
π Key Features of This Vault
1. Interconnected Knowledge
Everything links to everything. Click through to understand relationships.
- Concept β Theory (STEM-Core) β Application (Projects) β Community Aspect (Community-Building)
2. Problem-Focused
Look up "what to do if..." and find real solutions from real failures.
3. Transparent Economics
Every recommendation includes cost, timeline, and why this over alternatives.
- Comparison matrices (e.g., Battery-Selection-Spreadsheet)
- Cost per unit calculations
- ROI analysis
4. Replicability
Notes are written so someone else can follow them without asking questions.
- BOM with links to exact components
- Photos at each step
- Test results and benchmarks
- Troubleshooting guides
5. Open-Source First
All designs, code, and knowledge assume open-source tools and sharing.
- No proprietary lock-in
- Alternative methods if you can't afford commercial option
- Attribution and sharing encouraged
6. Bias Toward Action
Read for 30 min, then build for 3 months. Knowledge solidifies through practice.
- Templates are ready-to-use
- Projects are immediately actionable
- Theory is just-in-time (learn when needed)
π οΈ Essential Tools
To use this vault fully, you'll need:
- Obsidian (free): Note-taking and knowledge management
- Basic text editor (if not using Obsidian): Edit markdown files
- Git (optional): Version control and collaborative editing
Recommended Obsidian plugins (community):
- Dataview: Query notes, create dynamic lists
- Templater: Auto-populate note templates
- Obsidian Git: Sync with GitHub
- Map of Contents: Auto-create MOC pages
π How to Read This Vault
For Quick Reference
- Use search (Cmd+F)
- Jump to relevant MOC
- Skim headings
- Find what you need
For Deep Learning
- Start with MOC
- Read foundational concepts first
- Follow links as they appear
- Take notes (create your own notes, link to vault)
- Try building something
For Community Discussion
- Share specific note (e.g., Consensus-Decision-Making)
- Discuss in group
- Update notes with group insights
- Document decisions made
π Vault Status & Contributing
Current Status:
- β Core sections: 95% complete
- β Templates: Ready to use
- π Projects: Growing (add yours!)
- π Vendor lists: Regionally variable (customize for your area)
- β STEM problem sets: In progress
Maintenance:
- This is a living document
- Pricing/vendor info updates regularly
- New project documentation ongoing
- Community contributions welcome
How to Keep Your Copy Updated:
- If on GitHub:
git pullperiodically - If downloaded: Subscribe to updates (email list, RSS, or GitHub watch)
- Add locally: Your improvements β share back if helpful
β FAQ
Q: Is this only for off-grid/rural people?
A: No. Principles apply everywhere: reducing costs, increasing resilience, sharing knowledge. Urban people use solar balconies, shared tool libraries, community gardens.
Q: Can I use this commercially?
A: Yes, with attribution. See LICENSE file. Open-source doesn't mean free β you can sell systems/services you build.
Q: How often is this updated?
A: Continuously, as community contributes. Major updates quarterly. Pricing info updates as new data available.
Q: What if I find an error?
A: Please report! Create GitHub issue or contact maintainers. This gets better with community feedback.
Q: Can I translate this?
A: Yes, please! Create regional variant (e.g., 01-Philosophy-ES/) and contribute back.
Q: How do I get started if I have no technical background?
A: Start with 01-CORE-VALUES + 09-COMMUNITY-MOC. Community building often comes before technical building. Find your people first.
π Related Resources
Movements & Communities
- Solarpunk: Hopeful vision of sustainable futures
- Ecopunk: DIY, salvage, scrappy resilience
- Transition Towns: Community-scale sustainability
- Permaculture Design: Systems thinking for land
- Mutual Aid Networks: Organizing for collective care
Organizations
- Seed Savers Exchange
- Open Source Ecology
- RepRap / Open Source Hardware
- Appropriate Technology organisations
- [See Resources folder for comprehensive links]
π Acknowledgments
This vault builds on:
- Kropotkin, Illich, Meadows, Solnit (theory)
- Hands-on builders and DIYers (practical knowledge)
- Open-source communities (code, designs, ethos)
- Indigenous and traditional knowledge (regenerative practices)
- Everyone who documented their failures (we learn more from those)
Contributors: [See Vault-Contributors for complete list]
π License
This vault is open-source.
- Text: CC BY-SA 4.0 (share, adapt, attribute)
- Code: GPL 3.0 (share, modify, use freely)
- Designs: CC BY-SA 4.0 (attribute, share improvements)
In short: Use freely, share improvements, give credit.
π Getting Started (Right Now)
- Read: 00-MOC/00-VAULT-HOME (5 min)
- Explore: Pick one MOC that interests you
- Find: One specific thing you want to build/learn
- Start: Use 11-Templates to plan your project
- Build: Document as you go
- Share: Add your experience back to vault
Questions? Check FAQ or open a discussion.
Found an error? Create an issue.
Have something to add? We want to hear it.
Welcome. Let's build something resilient together. π±
Last Updated: [DATE]
Maintained by: Community of contributors
Current Version: 1.0 (Foundation complete, expansion ongoing)