selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

SourceWeft logo

Self-host SourceWeft

v0.3.0-rc.8

AI workstation with agents, skills, and MCP

BetaOpen SourceOther
Updated6 days ago
LanguageTypescript
Setup difficultyModerate
Stars
333
Port
3001 (Internal API server)
Requires
PostgreSQL
Docker
ghcr.io/sourceweft/sourceweft
Install with Docker Compose
SourceWeft chat interface showing agent conversation with citations

What is SourceWeft?

SourceWeft is an open-source AI workstation you can run on your own hardware. It combines multi-agent collaboration with sub-agents, a reusable skill library, Model Context Protocol (MCP) integrations for external tools, and sandboxed code execution. You bring your own models and API keys, connect knowledge sources such as documents, cloud storage, email, chat platforms, and video sites, and access everything through a web interface or native desktop apps for macOS, Windows, and Linux. The project is in early access (v0.3.0 release candidates), uses the Apache-2.0 license, and offers a free tier alongside paid Pro and Team plans for higher limits and team features.

Should you self-host SourceWeft?

SourceWeft scores 48/100 on selfhost.directory (how scoring works) and ranks #52 of 120 in AI Assistant. It has 333 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is openhands (87/100, 92 086 stars). It scores higher overall, so compare the two before you pick. See SourceWeft vs openhands side by side.

Features

  • Bring Your Own Keys (BYOK)
  • Cross-Platform Access
  • Document creation
  • Knowledge & citations
  • MCP integrations
  • Multi-Agent Collaboration
  • Sandboxed ExecutionAlpha feature, requires configured runtime
  • Skill library
  • Team workspaces with RBACTeam plan feature

SourceWeft README

How to install SourceWeft

Install SourceWeft with Docker Compose

VERSION=v0.3.0-rc.8 IMAGE=ghcr.io/sourceweft/sourceweft:$VERSION docker run --rm --user "$(id -u):$(id -g)" --entrypoint node
-e SOURCEWEFT_IMAGE="$IMAGE" -v "$PWD/docker:/config" "$IMAGE"
/app/docker/init-config.mjs /config docker compose --env-file docker/.env -f docker/docker-compose.yml up -d --wait --wait-timeout 300

Requires Docker Engine/Desktop with Compose v2.24+ and POSIX shell (Linux/macOS/WSL). Download sourceweft-selfhost-vX.Y.Z.tar.gz from Releases.

How to configure SourceWeft

  • ANYCRAWL_API_KEYAPI key for web search/fetch (AnyCrawl)

    API key for web search/fetch (AnyCrawl)

    values: API key

  • BETTER_AUTH_SECRETAuthentication secret (generated by initializer)

    Authentication secret (generated by initializer)

    values: Secret string

  • DATABASE_URLFull PostgreSQL connection string (optional, for external DB)

    Full PostgreSQL connection string (optional, for external DB)

    values: PostgreSQL connection string

  • DB_HOSTpostgresPostgreSQL host

    PostgreSQL host

    values: Hostname or IP

  • DB_NAMEsourceweftPostgreSQL database name

    PostgreSQL database name

    values: Database name

  • DB_PASSWORDPostgreSQL password (generated by initializer)

    PostgreSQL password (generated by initializer)

    values: Secret string

  • DB_PORT5432PostgreSQL port

    PostgreSQL port

    values: Port number

  • DB_USERsourceweftPostgreSQL username

    PostgreSQL username

    values: Username

  • GMAIL_CONNECTOR_ENABLEDfalseEnable Gmail connector

    Enable Gmail connector

    values: true/false

  • MODEL_GATEWAY_ENCRYPTION_SECRETEncryption secret for model gateway (generated by initializer)

    Encryption secret for model gateway (generated by initializer)

    values: Secret string

  • NOTION_BLOG_API_KEYNotion API key for blog integration

    Notion API key for blog integration

    values: Notion API key

  • OPENROUTER_ENABLEDtrueEnable OpenRouter model provider

    Enable OpenRouter model provider

    values: true/false

  • PUBLIC_API_BASE_URLPublic origin for the API (blank = same as web)

    Public origin for the API (blank = same as web)

    values: Any valid URL or blank

  • PUBLIC_WEB_BASE_URLhttp://localhost:3000Public origin for the web UI (e.g., https://notes.example.com)

    Public origin for the web UI (e.g., https://notes.example.com)

    values: Any valid URL

  • REDIS_URLredis://redis:6379/0Redis connection URL

    Redis connection URL

    values: Redis URL

  • S3_ACCESS_KEY_IDsourceweftS3 access key ID

    S3 access key ID

    values: Access key

  • S3_BUCKETsourceweft-uploadsS3 bucket name for uploads

    S3 bucket name for uploads

    values: Bucket name

  • S3_ENDPOINThttp://storage:8333S3-compatible storage endpoint

    S3-compatible storage endpoint

    values: S3 endpoint URL

  • S3_SECRET_ACCESS_KEYS3 secret access key (generated by initializer)

    S3 secret access key (generated by initializer)

    values: Secret key

  • SOURCEWEFT_SANDBOX_ENABLEDfalseEnable sandboxed code execution

    Enable sandboxed code execution

    values: true/false

  • SOURCEWEFT_SANDBOX_PROVIDERdaytonaSandbox provider (daytona)

    Sandbox provider (daytona)

    values: daytona

  • WEB_PORT3000Port the gateway listens on (host side)

    Port the gateway listens on (host side)

    values: Any valid port number

More in Knowledge Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…