Skip to content

QUICK-START.md

Latest commit

 

History

History
137 lines (103 loc) · 3.06 KB

QUICK-START.md

File metadata and controls

137 lines (103 loc) · 3.06 KB
Raw

Soulfield OS - Quick Start

Get up and running in 30 seconds

Prerequisites

  1. API Key Setup
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY (required)

Get your API key from: https://console.anthropic.com

  1. Starting the Server
./start-server.sh

That's it! The script automatically:

  • ✅ Kills old processes
  • ✅ Clears port 8790
  • ✅ Starts server
  • ✅ Verifies it's working

Testing

# Health check
curl http://localhost:8790/health

# Test marketing agent
curl -X POST http://localhost:8790/chat \
  -H "Content-Type: application/json" \
  -d '{"text":"@marketing test"}'

Server Management

./server-status.sh   # Check if running
./stop-server.sh     # Stop server
./restart-server.sh  # Restart server

Logs

# Real-time logs
tail -f /tmp/soulfield-server.log

# Search logs
grep "LocalGraph" /tmp/soulfield-server.log
grep "Marketing" /tmp/soulfield-server.log

Available Agents

Agent Alias Purpose
Governor @aiden Strategic orchestration
Marketing @marketing Campaign strategies
Finance @finance Financial analysis
SEO @seo SEO optimization
Builder @builder MVP development
Distributor @distributor Distribution strategy
Metrics @metrics Analytics tracking

Example Queries

# Marketing campaign
curl -X POST http://localhost:8790/chat \
  -H "Content-Type: application/json" \
  -d '{"text":"@marketing Create a launch campaign for AI SaaS"}' \
  -m 35

# Financial analysis
curl -X POST http://localhost:8790/chat \
  -H "Content-Type: application/json" \
  -d '{"text":"@finance Analyze burn rate for 6-month runway"}' \
  -m 35

# SEO strategy
curl -X POST http://localhost:8790/chat \
  -H "Content-Type: application/json" \
  -d '{"text":"@seo Keyword research for productivity tools"}' \
  -m 35

Documentation

Key Features

  • 🎯 16 specialized agents with lens-validated outputs
  • 📊 Local graph analysis (10-50x faster, $0/month)
  • 🔒 100% privacy (data never leaves machine)
  • 💾 Supabase memory (pgvector for agent context)
  • 📁 Agent File System (automatic Google Drive sync)
  • 🔍 6-lens framework (truth verification)

Port & Process Issues? SOLVED!

No more manual process killing or port conflicts.

Before:

pkill -f "node backend/index.cjs"
lsof -ti :8790 | xargs kill -9
export PORT=8790
node backend/index.cjs > /tmp/soulfield.log 2>&1 &
# Did it work? Who knows...

After:

./start-server.sh
# ✓ Server started successfully!

Getting Help

./server-status.sh     # Check server status
tail -f /tmp/soulfield-server.log  # View logs

See SERVER-MANAGEMENT.md for detailed troubleshooting.

That's it! You're ready to use Soulfield OS. 🚀