📚 Getting Started Guide: Setting Up SODEA & Morpheus

Introduction

Welcome to SODEA! This guide will walk you through setting up Morpheus, understanding semantic objects (SOs), and getting hands-on with Fountain. Whether you're new or experienced, you'll have a working environment ready to explore semantic architectures.

---

Step 1: Install Prerequisites

1️⃣ Install Node.js and npm: Morpheus and Fountain require Node.js. Download from nodejs.org and install globally.

node -v
npm -v

2️⃣ Install Git (Optional): If you want to clone repositories or contribute code.

git --version

---

Step 2: Download and Install Morpheus

1️⃣ Get the latest release of Morpheus:

• Clone from GitHub or download a release zip.

git clone https://github.com/sodea/morpheus.git
cd morpheus

2️⃣ Install dependencies:

npm install

3️⃣ Configure Environment Variables: Create a .env.local file in the root with:

MORPHEUS_API_URL=http://localhost:4000/api
AUTH_KEY=your_auth_key

---

Step 3: Launch Morpheus

Run the server:

npm run dev

• Morpheus should be accessible at http://localhost:3000/morpheus.
• The default port can be changed in configuration.

---

Step 4: Launch Fountain

1️⃣ Get the Fountain source:

• Clone from GitHub or download:

git clone https://github.com/sodea/fountain.git
cd fountain
npm install

2️⃣ Configure Fountain to connect to Morpheus:

• Update .env.local in Fountain:

MORPHEUS_API_URL=http://localhost:3000/morpheus/api

3️⃣ Run Fountain:

npm run dev

• Access Fountain at http://localhost:3000/fountain.

---

Step 5: Understand Semantic Objects (SOs)

• SOs are JSON-LD structures modeling data and behaviors.
• Each SO can include attributes, links, and private logic.
• Example:

{
  "@context": "https://schema.sodea.org/core#",
  "@id": "urn:demo:counter",
  "@type": "CounterObject",
  "counter": 0,
  "status": "active",
  "_private": {
    "hooks": {
      "onEvent": { "code": "...", "language": "python" }
    }
  }
}

---

Step 6: Explore Sample Workflows

• Import provided sample projects into Fountain.
• Watch Morpheus execute hooks and update SOs dynamically.
• Try modifying logic and relationships in real time.

---

Step 7: Join the Community

• Visit the Community page to contribute, ask questions, and participate in governance.
• Start with a post in the General Discussion or Proposals categories.

---

Next Steps

✅ Dive deeper into the API Reference. ✅ Explore the Governance System. ✅ Read advanced Fountain Tutorials.