{"id":47741638,"url":"https://github.com/adminlove520/superdreams","last_synced_at":"2026-04-08T04:00:29.136Z","repository":{"id":348636145,"uuid":"1199063906","full_name":"adminlove520/SuperDreams","owner":"adminlove520","description":"赛博永生·数字生命","archived":false,"fork":false,"pushed_at":"2026-04-03T03:47:32.000Z","size":12676,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-05T01:10:03.044Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://xiaoxi-dreams.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adminlove520.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"adminlove520"}},"created_at":"2026-04-02T02:45:31.000Z","updated_at":"2026-04-03T04:41:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/adminlove520/SuperDreams","commit_stats":null,"previous_names":["adminlove520/xiaoxi-dreams"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/adminlove520/SuperDreams","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adminlove520%2FSuperDreams","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adminlove520%2FSuperDreams/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adminlove520%2FSuperDreams/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adminlove520%2FSuperDreams/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adminlove520","download_url":"https://codeload.github.com/adminlove520/SuperDreams/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adminlove520%2FSuperDreams/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31456664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-02T23:57:53.049Z","updated_at":"2026-04-06T02:00:46.722Z","avatar_url":"https://github.com/adminlove520.png","language":"TypeScript","funding_links":["https://github.com/sponsors/adminlove520"],"categories":[],"sub_categories":[],"readme":"# SuperDreams\n\n\u003e AI Agent Cognitive Memory System - Memory consolidation through \"dreaming\"\n\n[![Version](https://img.shields.io/badge/version-4.1.1-green)](https://github.com/adminlove520/SuperDreams)\n[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)\n\n## What is SuperDreams?\n\nSuperDreams provides a real memory system for AI Agents (we call them **Lobsters**). Each Agent periodically \"dreams\" -- scanning logs, extracting knowledge, consolidating memories, and evaluating cognitive health -- achieving continuous cognitive evolution.\n\n### Core Features\n\n- **Real Dream Engine** -- Scan logs -\u003e Extract memories -\u003e Deduplicate -\u003e Score -\u003e Generate report\n- **5-Dimension Health Assessment** -- Freshness, Coverage, Coherence, Efficiency, Accessibility\n- **Agent Dashboard** -- Each agent has its own memory visualization panel with neon glow UI\n- **Control Center** -- Multi-agent management, cross-agent search\n- **Dual Storage Backend** -- Auto-switches between Upstash Redis (production) and SQLite (development)\n- **Vercel Compatible** -- One-click cloud deployment with persistent storage\n\n## Architecture\n\n```\nSuperDreams/\n+-- agent/              # Agent Dashboard (Next.js 14.2.35 + sql.js/Upstash Redis)\n|   +-- app/            #   Dashboard Pages + API Routes\n|   +-- components/     #   UI (HealthRing, MemoryMatrix, SyncLog, etc.)\n|   +-- lib/            #   Core (store.ts, db.ts, dream-engine.ts, health.ts)\n|   +-- data/           #   SQLite database (local dev)\n+-- center/             # Control Center (Next.js + better-sqlite3/Upstash Redis)\n|   +-- app/            #   Dashboard + API\n|   +-- lib/            #   Auth + Store\n+-- docs/               # Documentation\n|   +-- architecture.md #   System architecture diagrams\n|   +-- data-flow.md    #   Data flow and logic diagrams\n|   +-- agent-guide.md  #   Agent deployment and usage guide\n|   +-- center-guide.md #   Center deployment and usage guide\n+-- SKILLS/             # Agent Skills\n|   +-- superdreams-agent.md  # Skill for AI agents to manage memories via API\n+-- scripts/            # CLI tools\n+-- memory/             # Log files (dream scan source)\n```\n\n## Quick Start\n\n### 1. Clone and Install\n\n```bash\ngit clone https://github.com/adminlove520/SuperDreams.git\ncd SuperDreams\n\n# Agent Dashboard\ncd agent \u0026\u0026 npm install\n\n# Control Center (optional)\ncd ../center \u0026\u0026 npm install\n```\n\n### 2. Start Agent Dashboard\n\n```bash\ncd agent\nnpm run dev\n# Visit http://localhost:3000\n```\n\n### 3. Trigger First Dream\n\n```bash\n# From root directory\nnode scripts/dream.js\n```\n\n### 4. Deploy to Vercel (Production)\n\n```bash\n# Agent project\n# Set env vars: UPSTASH_REDIS_REST_URL + UPSTASH_REDIS_REST_TOKEN\n# Build command auto-runs: cd agent \u0026\u0026 npm install \u0026\u0026 npm run build\n```\n\nSee [Agent Deployment Guide](docs/agent-guide.md) and [Center Deployment Guide](docs/center-guide.md) for details.\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Architecture](docs/architecture.md) | System architecture, component design, storage layer |\n| [Data Flow](docs/data-flow.md) | Memory upload, dream, sync, health calculation flows |\n| [Agent Guide](docs/agent-guide.md) | Agent deployment, API reference, Skill integration |\n| [Center Guide](docs/center-guide.md) | Center deployment, multi-agent management, sync setup |\n| [API Reference](SKILLS/api.md) | REST API endpoints |\n\n## Storage\n\nSuperDreams uses a **dual-backend storage layer** that auto-detects the environment:\n\n| Environment | Agent Storage | Center Storage |\n|-------------|--------------|----------------|\n| Local Dev | sql.js (WASM SQLite) | better-sqlite3 |\n| Vercel/Production | Upstash Redis | Upstash Redis |\n\nDetection: If `UPSTASH_REDIS_REST_URL` env var exists -\u003e Upstash Redis, otherwise -\u003e SQLite.\n\nKey prefixes: Agent uses `sd:`, Center uses `ctr:` to avoid collision when sharing the same Redis instance.\n\n## AI Agent Integration (Skill)\n\nAI Agents (like openclaw) can manage their memories via the `superdreams-agent` Skill:\n\n```\n# Upload a memory\nPOST /api/memories { name, type, summary, content, importance, tags }\n\n# Trigger dreaming\nPOST /api/dreams\n\n# Check health\nGET /api/health\n\n# Sync to Center\nPOST /api/sync { centerUrl, apiKey }\n```\n\nSee [SKILLS/superdreams-agent.md](SKILLS/superdreams-agent.md) for full Skill documentation.\n\n## Roadmap\n\n- [x] v4.0 Architecture refactor (SQLite + Monorepo)\n- [x] Real dream engine\n- [x] 5-dimension health scoring\n- [x] v4.1 Neon glow UI + Memory Matrix + Sync Log + Upstash Redis\n- [ ] Vector search for memories (RAG)\n- [ ] Automated tweet/weekly report generation\n\n## Contributing\n\nPRs and Issues welcome. Let's build cyber memories for AI together.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadminlove520%2Fsuperdreams","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadminlove520%2Fsuperdreams","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadminlove520%2Fsuperdreams/lists"}