Blinko: Self-hosted AI-powered personal note tool

Key Features:
├── AI-Enhanced Note Retrieval (RAG-powered natural language search)
├── Data Ownership (100% self-hosted, complete privacy control)
├── Efficient & Fast (plain text storage with Markdown support)
├── Multi-platform Support (macOS, Windows, Android, Linux via Tauri)
├── Open Source (transparent, community-driven development)
└── Lightweight Architecture (clean, performant, Tauri-based)

Architecture Overview:
├── Monorepo (Bun + Turbo)
│   ├── @blinko/frontend (app/)
│   │   ├── React 18 + Vite
│   │   ├── Tauri 2 (desktop)
│   │   └── HeroUI + Tailwind CSS 4
│   ├── @blinko/backend (server/)
│   │   ├── Express 5 + tRPC
│   │   ├── Prisma + PostgreSQL
│   │   └── Vercel AI SDK + RAG
│   └── shared/
├── Database: PostgreSQL + pgvector
├── Queue: pg-boss
└── Deployment: Docker, K8s, Tauri

# Official one-click install script
curl -s https://raw.githubusercontent.com/blinko-space/blinko/main/install.sh | bash

# The script will:
# 1. Create Docker network 'blinko-network'
# 2. Start PostgreSQL container 'blinko-postgres'
# 3. Optionally mount a local .blinko directory
# 4. Start Blinko container 'blinko-website'

# Access Blinko at: http://localhost:1111

git clone https://github.com/blinko-space/blinko.git
cd blinko

# docker-compose.yml (production-ready)
version: '3'

networks:
  blinko-network:
    driver: bridge

services:
  blinko-website:
    container_name: blinko-website
    image: blinkospace/blinko:latest
    environment:
      NODE_ENV: production
      NEXTAUTH_URL: http://localhost:1111
      NEXT_PUBLIC_BASE_URL: http://localhost:1111
      NEXTAUTH_SECRET: "your-secure-secret-change-in-production"
      DATABASE_URL: postgresql://postgres:mysecretpassword@blinko-postgres:5432/postgres
    depends_on:
      postgres:
        condition: service_healthy
    restart: always
    ports:
      - 1111:1111
    healthcheck:
      test: ["CMD", "wget", "--spider", "http://blinko-website:1111/"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 30s
    networks:
      - blinko-network

  postgres:
    image: postgres:14
    container_name: blinko-postgres
    restart: always
    environment:
      POSTGRES_DB: postgres
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: mysecretpassword
    healthcheck:
      test: ["CMD", "pg_isready", "-U", "postgres", "-d", "postgres"]
      interval: 5s
      timeout: 10s
      retries: 5
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - blinko-network

volumes:
  postgres_data:

# Start services (detached mode)
docker compose up -d

# View logs
docker compose logs -f

# Stop services
docker compose down

# Stop and remove volumes (WARNING: deletes all data)
docker compose down -v

# Restart services
docker compose restart

# Check status
docker compose ps

# Generate a secure NEXTAUTH_SECRET
# Using openssl:
openssl rand -base64 32

# Or use Node:
node -e "const crypto = require('crypto'); console.log(crypto.randomBytes(32).toString('hex'))"

# Example .env file for production:
# NODE_ENV=production
# NEXTAUTH_URL=https://blinko.yourdomain.com
# NEXT_PUBLIC_BASE_URL=https://blinko.yourdomain.com
# NEXTAUTH_SECRET=your-generated-secret-here
# DATABASE_URL=postgresql://postgres:password@postgres:5432/postgres
#
# AI Provider Keys (optional):
# OPENAI_API_KEY=sk-...
# ANTHROPIC_API_KEY=sk-ant-...
# OLLAMA_BASE_URL=http://localhost:11434

# Install using Helm (with included PostgreSQL)
helm install blinko ./helm \
  --set config.baseUrl=https://blinko.yourdomain.com \
  --set config.nextauth.url=https://blinko.yourdomain.com \
  --set config.nextauth.secret=your-secure-secret \
  --set service.type=LoadBalancer

# Use external PostgreSQL instead
helm install blinko ./helm \
  --set postgresql.enabled=false \
  --set externalDatabase.enabled=true \
  --set externalDatabase.host=your-db-host \
  --set externalDatabase.username=postgres \
  --set externalDatabase.password=your-password \
  --set externalDatabase.database=postgres

# Check deployment
kubectl get pods -l app.kubernetes.io/name=blinko
kubectl get svc -l app.kubernetes.io/name=blinko

# Uninstall
helm uninstall blinko

# Clone repository
git clone --recursive https://github.com/blinko-space/blinko.git
cd blinko

# Install dependencies
bun install

# Start PostgreSQL (for development)
docker run -d \
  --name blinko-dev-postgres \
  -e POSTGRES_DB=postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  postgres:14

# Generate Prisma client
cd prisma && prisma generate && prisma migrate dev && cd ..

# Start development servers
# Backend only
bun run dev:backend

# Frontend only
bun run dev:frontend

# Full stack with Tauri desktop app
bun run dev

# Run tests
bun run test

# Build for production
bun run build:web

# Run Prisma Studio (database GUI)
bun run prisma:studio

Feature Highlights:
├── Note Editing
│   ├── Vditor Markdown Editor
│   ├── KaTeX Math Support
│   └── Mermaid/MarkMap Diagrams
├── AI Features
│   ├── RAG Search
│   ├── Multi-Provider LLM Support
│   └── Tavily Web Search
├── Desktop (Tauri)
│   ├── System Integration
│   ├── Global Shortcuts
│   └── Auto-updates
├── Auth (Passport.js)
│   ├── Local Login
│   ├── 15+ OAuth Providers
│   └── 2FA Support
└── UI/UX
    ├── HeroUI Components
    ├── Framer Motion Animations
    ├── Dark/Light Themes
    └── i18n (Internationalization)

# Example: Mount persistent storage for uploads
# In docker-compose.yml, add to blinko-website:

volumes:
  - ./uploads:/app/uploads
  - ./backups:/app/backups

# Example: Nginx reverse proxy for TLS
# nginx.conf:
server {
    listen 443 ssl;
    server_name blinko.yourdomain.com;
    
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;
    
    location / {
        proxy_pass http://blinko-website:1111;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

sudo xattr -rd com.apple.quarantine /Applications/blinko.app

docker ps | grep blinko
docker compose logs blinko-website

docker compose logs blinko-postgres
docker exec -it blinko-postgres psql -U postgres -d postgres

cd prisma && prisma migrate reset && cd ..

# Common troubleshooting commands

# Restart all containers
docker compose down && docker compose up -d

# Clean and rebuild Docker images
docker compose down -v
docker compose build --no-cache
docker compose up -d

# Check container logs
docker compose logs -f blinko-website
docker compose logs -f blinko-postgres

# Access PostgreSQL directly
sudo docker exec -it blinko-postgres psql -U postgres -d postgres

# Reset database (WARNING: deletes all data)
docker compose down -v
docker compose up -d

# Backup database
sudo docker exec -t blinko-postgres pg_dumpall -c -U postgres > backup.sql

# Restore database
sudo docker exec -i blinko-postgres psql -U postgres -d postgres < backup.sql

# MacOS quarantine fix
sudo xattr -rd com.apple.quarantine /Applications/blinko.app

Links:
├── GitHub: https://github.com/blinko-space/blinko
├── Website: https://blinko.space
├── Docs: https://docs.blinko.space/
├── Demo: https://demo.blinko.space
├── Telegram EN: https://t.me/blinkoEnglish
└── Deploy: https://www.pikapods.com/pods?run=blinko

Stats:
├── Stars: 10,400+
├── Forks: 742+
├── Contributors: 50+
├── Docker Pulls: 50,000+
└── Latest: v1.8.7