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:

It combines:


πŸ—ΊοΈ How to Navigate

First Time Here?

  1. Start: 00-MOC/00-VAULT-HOME
  2. Read: 01-Philosophy/01-CORE-VALUES (5 min)
  3. Pick your entry path:

Looking for Something Specific?

Use Obsidian's Search (Cmd/Ctrl+F) or Graph View to find related topics.

Key search terms:

Want to Deep Dive?

Each folder has a MOC (Map of Contents):


πŸ“ 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:


πŸ’» How to Use This Vault

  1. Download the vault folder
  2. Open in Obsidian (File β†’ Open Vault β†’ select folder)
  3. 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

Option 3: Export & Print (Partial)


✏️ How to Adapt This Vault

This vault is a template, not gospel. Customize it for your context:

Add Your Own Projects

  1. Copy 11-Templates/TEMPLATES-INDEX β†’ Project-Template
  2. Rename with date: 2024-02-15-PROJECT-My-Build
  3. Place in 10-Projects/ folder
  4. Link from 10-Projects/10-PROJECTS-MOC
  5. Document as you go (photos, challenges, lessons)

Adapt to Your Bioregion

Create Specialized Sections

Add folders for:


🀝 Contributing Back

This vault is stronger with community input.

Ways to Contribute

Document a project:

Improve existing notes:

Add resources:

Translate or localize:

How to Submit

Via GitHub (if you know git):

  1. Fork repository
  2. Create branch: feature/your-improvement
  3. Commit changes
  4. Open Pull Request with description

Via Issue/Discussion:

Via Email/Contact:


πŸŽ“ How to Use This for Learning

Study Path 1: Energy Systems (12 weeks)

Outcome: Can design and implement a small renewable system

Study Path 2: Local LLM Systems (8 weeks)

Outcome: Can run and customize local LLM systems

Study Path 3: Community Organization (Ongoing)

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.

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.

4. Replicability

Notes are written so someone else can follow them without asking questions.

5. Open-Source First

All designs, code, and knowledge assume open-source tools and sharing.

6. Bias Toward Action

Read for 30 min, then build for 3 months. Knowledge solidifies through practice.


πŸ› οΈ Essential Tools

To use this vault fully, you'll need:

Recommended Obsidian plugins (community):


πŸ“– How to Read This Vault

For Quick Reference

  1. Use search (Cmd+F)
  2. Jump to relevant MOC
  3. Skim headings
  4. Find what you need

For Deep Learning

  1. Start with MOC
  2. Read foundational concepts first
  3. Follow links as they appear
  4. Take notes (create your own notes, link to vault)
  5. Try building something

For Community Discussion

  1. Share specific note (e.g., Consensus-Decision-Making)
  2. Discuss in group
  3. Update notes with group insights
  4. Document decisions made

🌐 Vault Status & Contributing

Current Status:

Maintenance:

How to Keep Your Copy Updated:

  1. If on GitHub: git pull periodically
  2. If downloaded: Subscribe to updates (email list, RSS, or GitHub watch)
  3. 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.


Movements & Communities

Organizations


πŸ™ Acknowledgments

This vault builds on:

Contributors: [See Vault-Contributors for complete list]


πŸ“ License

This vault is open-source.

In short: Use freely, share improvements, give credit.


πŸš€ Getting Started (Right Now)

  1. Read: 00-MOC/00-VAULT-HOME (5 min)
  2. Explore: Pick one MOC that interests you
  3. Find: One specific thing you want to build/learn
  4. Start: Use 11-Templates to plan your project
  5. Build: Document as you go
  6. 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)

Powered by Forestry.md