Deployment Guide

This guide covers deploying the complete Claude personal assistant setup with:

• Takopi - Telegram bridge for Claude Code
• Quartz - Static site generator for publishing notes
• Cloudflare Pages - Hosting for Quartz

Quick Start

# Clone this repo and run setup
git clone git@github.com:YOUR_USERNAME/YOUR_REPO.git
cd YOUR_REPO/deployment
./setup.sh

Components

Component	Purpose	Docs
[[deployment/takopi	Takopi]]	Telegram → Claude bridge
[[deployment/quartz	Quartz]]	Notes → Website
[[deployment/cloudflare	Cloudflare]]	Hosting + DNS

Prerequisites

• Ubuntu 20.04+ (or similar Linux)
• Node.js 22+ (via nvm)
• Python 3.8+
• Git
• Domain (optional, for custom domain)

Secrets Required

Store these securely (not in git):

Secret	Where to get	Used by
TELEGRAM_BOT_TOKEN	@BotFather on Telegram	Takopi
TELEGRAM_CHAT_ID	Use @userinfobot or API	Takopi
CLOUDFLARE_API_TOKEN	Cloudflare dashboard	Quartz deploy
GitHub SSH key	Generate locally	Git push

File Structure

deployment/
├── README.md           # This file
├── takopi.md           # Takopi setup guide
├── quartz.md           # Quartz setup guide
├── cloudflare.md       # Cloudflare setup guide
├── setup.sh            # Main setup script
├── configs/
│   ├── takopi.toml.example
│   └── ssh-config.example
└── scripts/
    ├── install-deps.sh
    ├── setup-takopi.sh
    ├── setup-quartz.sh
    └── setup-cloudflare.sh