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.

GitHub
Friday logo

Self-host Friday

v1.0.2

Private AI agent control plane with approval automation

BetaOpen SourceMIT
Updated4 months ago
LanguageTypescript
Setup difficultyModerate
Stars
836
Port
3141 (Friday hub HTTP interface)
Requires
Node.js
Install with Docker Compose
Friday screenshot 1Friday screenshot 2

What is Friday?

Friday is a private control plane for AI agents that runs locally on your machine while using cloud models you already pay for. It builds a loop that finds work, assigns it to appropriate AI models, verifies completion with proof receipts, records results, and manages what's next—all under your supervision. Risky steps pause for manual approval, while safe work proceeds automatically. The system maintains memory of confirmed facts, logs hash-chained audit trails, and supports optional inbound channels like Discord, Telegram, and Lark/Feishu for task intake.

Should you self-host Friday?

Friday scores 49/100 on selfhost.directory (how scoring works) and ranks #21 of 26 in Automation. It has 836 GitHub stars.

It shipped 4 stable releases in the past year. The latest, v1.0.2, came out on 26 May 2026. New versions land roughly every 3 weeks.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Node RED (81/100, 23 791 stars). It scores higher overall, so compare the two before you pick. See Friday vs Node RED side by side.

Friday README

How to install Friday

Install Friday with Docker Compose

Environment variables
FRIDAY_PORT, FRIDAY_HOST, FRIDAY_STATE_DIR, FRIDAY_SKILLS_DIR, FRIDAY_TOKEN_SECRET, FRIDAY_CORS_ORIGINS, FRIDAY_LOG_REQUESTS, OLLAMA_PORT

docker compose -f docker/docker-compose.yml up --build

Developer path with optional Ollama container via --profile local-llm

How to configure Friday

  • FRIDAY_CORS_ORIGINSAllowed CORS origins

    Allowed CORS origins

  • FRIDAY_HOST0.0.0.0Host address Friday binds to

    Host address Friday binds to

  • FRIDAY_LOG_REQUESTStrueEnable request logging

    Enable request logging

  • FRIDAY_PORT3141Port Friday listens on

    Port Friday listens on

  • FRIDAY_SKILLS_DIR/skillsSkills directory path

    Skills directory path

  • FRIDAY_STATE_DIR/dataState directory path

    State directory path

  • FRIDAY_TOKEN_SECRETToken secret for authentication

    Token secret for authentication

  • OLLAMA_PORT11434Ollama port when using local-llm profile

    Ollama port when using local-llm profile

Friday releases & version history

More in Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…