Infra-SIN-Setup

Single source of truth for setting up OpenSIN — developer environments AND end-user first-run.

Renamed focus after April 2026 consolidation: this repo now covers both audiences that were previously split across Infra-SIN-Dev-Setup and the standalone OpenSIN-onboarding repo.

Two entry points

I am a developer — I want to work on OpenSIN code

You are in the right place. Read:

• macOS-dev-setup.md
• OCI-dev-setup.md
• CloudFlare-dev-setup.md
• OpenCode/OpenCode-dev-setup.md
• opencode-docker-build/

I am an end user — I just installed OpenSIN and want it to work

See user-onboarding/. It contains the autonomous first-run scripts that set up:

1. A2A-SIN-Passwordmanager (Google Cloud Secrets backend)
2. OpenSIN Bridge Chrome Extension (CLI sideload)
3. API accounts on free-tier platforms (NVIDIA NIM, Groq, Hugging Face, etc.)
4. gcloud service account for secrets management
5. Seed credentials into the Passwordmanager vault

Entry script: user-onboarding/scripts/onboard.sh. Phases: phase1 → phase6.

Canonical position

This repo is owned by the Infra-SIN-* domain in the OpenSIN-AI organization. It is NOT where you write product code — product code lives in:

• OpenSIN-AI/OpenSIN — Python kernel
• OpenSIN-AI/OpenSIN-Code — autonomous CLI
• OpenSIN-AI/OpenSIN-backend — control plane
• OpenSIN-AI/Team-SIN-Code-Core — coding-team monorepo

Full ownership map: OpenSIN-overview/docs/CANONICAL-REPOS.md.

What moved here in April 2026

OpenSIN-AI/OpenSIN-onboarding — a 39 KB standalone repo — was absorbed as user-onboarding/ and archived. Its whole history is preserved upstream and its source tree is intact here, just one directory deep. Rationale: "set up the dev environment" and "set up the end-user environment" are the same domain with different audiences. Two repos for that was unnecessary and made it unclear where new setup automation should live.

---

Original README (preserved verbatim)

Infra-SIN-Dev-Setup

Quick Start · Was ist dies? · Setup Guide · Features · Architektur · Repositories · Related · Troubleshooting · Contributing

Dein komplettes OpenSIN-AI Development-Environment aufsetzen — von 0 auf produktiv in 30 Minuten.

---

Quick Start

1. OCI VM aufsetzen OCI-dev-setup.md

2. macOS Dev Environment macOS-dev-setup.md

3. OpenCode Stack upgraded-opencode-stack

[!TIP] Für eine vollständige OCI VM mit n8n, A2A-SIN-GitHub-Action und Box.com Storage → folge OCI-dev-setup.md Schritt für Schritt.

(back to top)

---

Was ist dies?

Dieses Repository dokumentiert und automatisiert das komplette OpenSIN-AI Development-Environment Setup. Es führt dich durch:

Bereich	Beschreibung
Oracle Cloud Infrastructure	Kostenlose A1.Flex VM (4 OCPUs, 24 GB RAM) mit n8n und allen A2A Services
macOS Development Environment	Homebrew, Git, Node.js, Bun, Python, VS Code — richtig konfiguriert
OpenCode CLI Stack	Der komplette upgraded-opencode-stack mit allen Skills, Plugins und Agents

Kein manuelles Setup mehr — folge den Anleitungen und dein System ist in 30 Minuten einsatzbereit.

(back to top)

---

Setup Guide

1. Oracle Cloud Account + VM erstellen → OCI-dev-setup.md — Schritt-für-Schritt Anleitung für:

• Oracle Cloud Free Tier Account anlegen
• A1.Flex Always-Free VM erstellen (4 OCPUs, 24 GB RAM)
• SSH Zugang einrichten
• Budget Alerts konfigurieren

[!IMPORTANT] Frankfurt (eu-frankfurt-1) hat 3 Availability Domains — wenn AD1 voll ist, probiere AD2 oder AD3. Alternativ: PAYGO Account erstellen (bleibt innerhalb Always-Free Limits, $300 Credits).

2. macOS Development Environment → macOS-dev-setup.md — Installation von:

• Homebrew (Paketmanager)
• Git (Versionskontrolle)
• Node.js + Bun (JavaScript Runtime — NICHT npm!)
• Python 3.12+
• VS Code
• SSH Key für GitHub
• Docker Desktop
• iTerm2 (empfohlen)

3. OpenCode Stack installieren

# upgraded-opencode-stack klonen
gh repo clone Delqhi/upgraded-opencode-stack ~/dev/upgraded-opencode-stack
cd ~/dev/upgraded-opencode-stack

# Installation
./install.sh

# Global Brain initialisieren (PFLICHT!)
node ~/.config/opencode/skills/global-brain/src/cli.js setup-hooks \
  --project $(basename "$PWD") \
  --project-root "$PWD" \
  --agents-directive

# Config syncen (nach OCI VM)
sin-sync

[!NOTE] Mehr Details im upgraded-opencode-stack Repository.

(back to top)

---

Features

Capability	Description	Status
Oracle Cloud A1.Flex	4 OCPUs, 24 GB RAM, Always-Free	✅
n8n Workflow Engine	Workflow Automation auf OCI VM	✅
A2A-SIN-GitHub-Action	CI/CD-ähnliche Automation (KEINE GitHub Actions!)	✅
Box.com Storage	Unlimited Cloud Storage für Logs/Screenshots	✅
OpenCode CLI	Mit 44 Skills, 4 Plugins, 21 Agents	✅
sin-sync	Config-Sync Mac → OCI VM → HF VMs	✅
Zentrales A2A Team Register	17 Teams klassifiziert in oh-my-sin.json	✅
Budget Alerts	OCI Cost Monitoring (Pflicht!)	✅

Vollständige Tool-Liste — Alle Komponenten

OCI VM Services

• n8n (Port 5678) — Workflow Automation
• A2A-SIN-GitHub-Action — GitHub Integration
• A2A-SIN-Box-Storage (Port 3000) — Cloud Storage
• sin-supabase — Datenbank (200 GB Storage)

OpenCode Stack

• 44 Custom Skills — A2A Agent Builder, Deploy, Debug, Browser Automation
• 4 Plugins — Antigravity OAuth, Qwen OAuth, OpenRouter Proxy
• 27 MCP Servers — sin-sync, sin-n8n, sin-telegrambot, sin-rotate, sin-health, etc.
• 12 Custom Commands — Swarm orchestration, Terminal orchestration, Zeus bootstrap
• 21 A2A Agents — Zeus, Simone, Frontend, Backend, Fullstack, etc.
• Global-Brain (DPMA v4) — Multi-Project Memory
• Local-Brain / GraphRAG — Projekt-basiertes Plan-Gedächtnis
• oh-my-sin.json — Zentrales A2A Team Register (17 Teams)

(back to top)

---

System Architecture

flowchart TB
 subgraph Mac["Mac (Local)"]
 OC[OpenCode CLI]
 BREW[Homebrew Stack]
 GIT[Git + SSH]
 end

 subgraph OCI["Oracle Cloud VM (OCI)"]
 N8N[n8n Workflow Engine<br/>Port 5678]
 BOX[A2A-SIN-Box-Storage<br/>Port 3000]
 GHACT[A2A-SIN-GitHub-Action]
 SUPABASE[sin-supabase DB<br/>200 GB]
 end

 subgraph Fleet["A2A Fleet"]
 ZS[SIN-Zeus<br/>Fleet Commander]
 SM[SIN-Simone-MCP<br/>Code Analysis]
 FE[A2A-SIN-Frontend]
 BE[A2A-SIN-Backend]
 end

 subgraph Remote["Remote VMs"]
 HF[HF Spaces]
 LAI[Lightning AI]
 end

 OC -->|sin-sync| N8N
 OC -->|sin-sync| BOX
 BREW --> OC
 GIT -->|git push| GHACT
 GHACT -->|dispatch| ZS
 ZS -->|task| SM
 ZS -->|task| FE
 ZS -->|task| BE
 N8N --> BOX
 SUPABASE -->|data| ZS
 OC -.->|sin-sync| HF
 OC -.->|sin-sync| LAI

 classDef macClass fill:#e1f5fe,stroke:#01579b,stroke-width:2px
 classDef ociClass fill:#fff3e0,stroke:#e65100,stroke-width:2px
 classDef fleetClass fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
 classDef remoteClass fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px

 class OC,BREW,GIT macClass
 class N8N,BOX,GHACT,SUPABASE ociClass
 class ZS,SM,FE,BE fleetClass
 class HF,LAI remoteClass

Loading

[!IMPORTANT] Wir nutzen KEINE GitHub Actions! Stattdessen läuft auf unserer OCI VM ein n8n Workflow mit A2A-SIN-GitHub-Action für CI/CD-ähnliche Automation.

(back to top)

---

Enthaltene Repos

Repository	Beschreibung	Link
Infra-SIN-Dev-Setup	Dieses Repo — Setup-Dokumentation	GitHub
upgraded-opencode-stack	Kompletter OpenCode CLI Stack — Skills, Plugins, Agents, Commands	GitHub
oh-my-sin.json	Zentrales A2A Team Register — 17 Teams klassifiziert	Im upgraded-opencode-stack

upgraded-opencode-stack — Enthaltene Komponenten

Komponente	Anzahl	Details
Skills	44	create-a2a, create-a2a-team, enterprise-deep-debug, browser-crashtest-lab, etc.
Plugins	4	opencode-antigravity-auth, opencode-qwen-auth, opencode-openrouter-auth, etc.
MCP Servers	27	sin-sync, sin-n8n, sin-telegrambot, sin-rotate, sin-health, etc.
Custom Commands	12	omoc-jam, omoc-max, sin-terminal-orchestrate, sin-zeus-bootstrap, etc.
A2A Agents	21	SIN-Zeus, SIN-Simone-MCP, A2A-SIN-Frontend, Backend, Fullstack, etc.
Provider Configs	5	Google Antigravity, OpenAI, NVIDIA NIM, OpenRouter, Qwen

Wichtigste Features:

• Global-Brain (DPMA v4) — Multi-Project Memory
• Local-Brain / GraphRAG — Projekt-basiertes Plan-Gedächtnis
• OMOC Swarm — 5-Agenten-Schwarm für komplexe Tasks
• sin-sync — Identische Configs auf Mac, OCI VM, HF VMs
• oh-my-sin.json — Zentrales A2A Team Register (17 Teams)

(back to top)

---

Related

Repository	Beschreibung
upgraded-opencode-stack	Der vollständige OpenCode CLI Stack — clone und installieren für sofortige A2A Agent Productivity
oh-my-sin.json	Zentrales A2A Team Register — 17 Teams (Coding, Worker, Infrastructure, Google Apps, Apple Apps, Social, Messaging, Forum, Legal, Commerce, Community, Research, Media, CyberSec, etc.)
OpenSIN-AI	Das OpenSIN-AI Ökosystem — Enterprise AI Agents die autonom arbeiten

(back to top)

---

Troubleshooting

Problem	Lösung
OCI A1.Flex "out of capacity"	Alle 3 ADs in Frankfurt probieren (AD1→AD2→AD3). Alternativ: PAYGO Account erstellen — bleibt kostenlos, nur $100 Hold.
macOS: brew: command not found	eval "$(brew shellenv)" ausführen oder Terminal neu starten
GitHub Push verlangt Passwort	SSH Key generieren und in GitHub Settings hinzufügen: ssh-keygen -t ed25519 -C "email"
n8n startet nicht auf OCI	sudo systemctl status n8n prüfen, Logs: sudo journalctl -u n8n -f
sin-sync schlägt fehl	OCI VM erreichbar? ping 92.5.60.87. SSH Key im authorized_keys?
Box.com Upload fehlgeschlagen	BOX_STORAGE_API_KEY in .env gesetzt? Service erreichbar? curl http://room-09-box-storage:3000/health

[!WARNING] Bei OOM-Kill (Process killed) auf macOS: NIEMALS npm nutzen! Immer bun install — npm frisst 4-6 GB RAM.

(back to top)

---

Contributing

1. Fork das Repository
2. Feature Branch erstellen (git checkout -b feature/amazing-feature)
3. Änderungen machen
4. Tests durchführen
5. Commit (git commit -m 'Add amazing feature')
6. Push (git push origin feature/amazing-feature)
7. Pull Request öffnen

[!NOTE] Für größere Änderungen: Erst Issue erstellen, dann PR.

---

License

Distributed under the MIT License. See LICENSE for more information.

---

_{Entwickelt vom OpenSIN-AI Ökosystem – Enterprise AI Agents die autonom arbeiten.
🌐 opensin.ai · 💬 Alle Agenten · 🚀 Dashboard}

(back to top)