Skip to content

nutstore/creatorweave

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

444 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

CreatorWeave

CreatorWeave: a local-first AI-native platform for creation, knowledge workflows, and multi-agent orchestration

Rust React TypeScript License: MIT

English | 简体中文

Try the live demo: creatorweave.eo2suite.cn

What is CreatorWeave?

CreatorWeave is a local-first AI-native creation platform. It combines file workflows, AI copilots, knowledge-base workflows, and multi-agent orchestration in one browser-native product.

Why CreatorWeave?

  • Built first for plain-text creation workflows: reduce context switching between editors, browsers, and terminals.
  • Browser-first by design: quick onboarding without requiring users to install an IDE or a heavy local setup.
  • Balances usability and safety: local files are accessed through explicit folder authorization, with scope constrained by browser permission boundaries.
  • Lowers branching complexity for non-Git users: workspaces can run in parallel, conceptually similar to git worktree, without requiring Git knowledge.

The project is also exploring multi-agent collaboration workflows for content creation, with configurable agent roles and coordination modes.

Key Product Description

  • AI-Powered Conversations: Chat naturally with your codebase using advanced AI agents with multi-agent collaboration
  • Knowledge Workflows: Build reusable context from project files and structured notes
  • Multi-Agent Orchestration: Design and run multi-step creative workflows with specialized agents
  • Local File Access: Direct interaction with files through modern browser APIs (File System Access API)
  • Code Intelligence: Understand, analyze, and manipulate code with 30+ intelligent tools
  • Python Integration: Execute Python code in the browser with Pyodide (pandas, numpy, matplotlib support)
  • Privacy First: All processing happens locally - your data never leaves your browser
  • Remote Control: Control your workspace from mobile devices via encrypted relay server

Features

Conversation System

  • Threading: Organize conversations into threads for better context management
  • Message Bubbles: Rich message display with markdown support, syntax highlighting, and inline code rendering
  • Reasoning Visualization: See AI thinking process with collapsible reasoning sections
  • Tool Call Display: View all tool invocations with parameters and results
  • Streaming Support: Real-time streaming of AI responses for faster feedback

Code Intelligence

  • File Tree Panel: Browse and explore your project structure
  • Syntax Highlighting: Code display with Shiki syntax highlighting
  • File Comparison: Side-by-side diff view for comparing file versions
  • Code Navigation: Quick access to files with line numbers and search

Data Analysis

  • Data Visualization: Chart.js integration for visualizing file statistics
  • Data Preview: Preview JSON, CSV, and other structured data formats
  • Batch Operations: Apply changes to multiple files at once
  • Advanced Search: Regex-based search with context lines
  • Data Export: Export analysis results to CSV, JSON, Excel, or image formats

Workspace Management

  • Theme Support: Light, dark, and system theme options
  • Keyboard Shortcuts: Command palette for quick access to all features (press Ctrl+K or Cmd+K)
  • Recent Files: Quick access to recently viewed files
  • Layout Persistence: Your workspace layout is saved automatically
  • Onboarding Tour: Guided tour for first-time users

Development Tools

  • Skills Manager: Create and manage reusable AI skills with on-demand loading
  • Tools Panel: Access 30+ development tools including file operations, code analysis, and data visualization
  • Python Integration: Execute Python code in the browser (Pyodide) with pandas, numpy, matplotlib, openpyxl
  • MCP Integration: Configure Model Context Protocol providers for extended capabilities
  • WASM Acceleration: High-performance file operations using Rust-compiled WebAssembly modules

User Scenarios

  • Developers: Code understanding, refactoring, debugging, and code review
  • Data Analysts: Data exploration, visualization, and report generation
  • Students: Learning assistance, problem-solving with step-by-step guidance
  • Office Workers: Document processing, data transformation, and automation

Keyboard Shortcuts

Shortcut Action
Ctrl/Cmd + K Open command palette
Ctrl/Cmd + B Toggle sidebar
Ctrl/Cmd + , Open workspace settings
Ctrl/Cmd + 1/2/3 Switch resource tabs
Shift + ? Show keyboard shortcuts
Escape Close panels/dialogs

Getting Started

Prerequisites

  • Node.js (18+)
  • pnpm (recommended) or npm/yarn
  • A modern browser with File System Access API support

Quick Start

# Clone the repository
git clone https://github.com/nutstore/creatorweave.git
cd creatorweave

# Install dependencies
pnpm install

# Start desktop web app
pnpm -C web run dev

# Open http://localhost:5173

Building for Production

# Build WASM modules
pnpm -C web run build:wasm

# Build web application
pnpm -C web run build

# Output in web/dist/

Development

Project Structure

creatorweave/
├── web/                    # React frontend application (Desktop)
│   ├── src/
│   │   ├── agent/         # AI agent logic, tools, multi-agent collaboration
│   │   ├── components/    # React components (UI, conversation, code viewer)
│   │   ├── hooks/         # Custom React hooks
│   │   ├── store/         # State management (Zustand stores)
│   │   ├── sqlite/        # SQLite WASM database layer
│   │   ├── python/        # Pyodide Python integration
│   │   ├── workers/       # Web Workers (file discovery, plugins)
│   │   └── export/        # Data export functionality
│   └── package.json
├── mobile-web/             # React frontend (Mobile Remote Control)
│   └── src/               # Mobile-optimized UI for remote sessions
├── relay-server/           # Socket.IO relay server for remote sessions
├── wasm/                   # Rust + WebAssembly modules
│   └── crates/            # Core logic, WASM bindings, plugin API/SDK
├── packages/               # Monorepo shared packages
│   ├── ui/                # Shared UI components (Radix UI + Storybook)
│   ├── conversation/      # Conversation components
│   ├── encryption/        # E2E encryption (ECDH + AES-GCM)
│   ├── i18n/              # Internationalization
│   └── config/            # Shared configurations
├── docs/                   # Project documentation
│   ├── architecture/      # Architecture documentation
│   ├── development/       # Development guides
│   └── design/            # Design specifications
└── scripts/                # Development and build scripts

Available Scripts

# Desktop Web (web/)
pnpm -C web run dev
pnpm -C web run build
pnpm -C web run preview

# Mobile Web (mobile-web/)
pnpm -C mobile-web run dev -- --port 3002
pnpm -C mobile-web run typecheck

# Relay Server (relay-server/)
pnpm -C relay-server run dev
pnpm -C relay-server run build

# Quality (web/)
pnpm -C web run lint
pnpm -C web run typecheck
pnpm -C web run test
pnpm -C web run test:e2e

Documentation

User Documentation

Developer Documentation

Technical Documentation

API Documentation

Roadmap

  • Attachment Directory (Planned): Workspace-level attachment storage for uploading files during conversations. Agent accesses attachments via vfs://attachments/ using existing read/ls tools. See Attachment Directory Design.
  • SubAgent Orchestration (Planned): Add native subagent dispatching, parallel execution scheduling, result aggregation, and guardrails for cross-agent context isolation and handoff quality.
  • LLM Wiki (Pending): Build an evolving knowledge-base workflow for ingest / query / lint, with structured claims and source traceability. See LLM Wiki Unified Spec and SubAgent Prerequisite for LLM Wiki.

Browser Compatibility

Browser Version File System Access OPFS SQLite WASM
Chrome 86+ Full support Full support Full support
Edge 86+ Full support Full support Full support
Firefox 111+ Partial Partial Partial*
Safari 16.4+ No No Fallback to IDB

*Firefox requires COOP/COEP headers to be configured.

Contributing

We welcome contributions. Please read:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Core Technologies

Libraries & Tools

Development Tools


Made with ❤️ by the community

About

Local-first AI workspace for creators — browser-based, privacy-first, multi-agent collaboration

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors