Skip to content

alexrozex/TattooClaw

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

25,930 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TattooClaw Logo

TattooClaw

AI-Powered Tattoo Studio Management β€” From Booking to Aftercare

Website β€’ Features β€’ Quick Start β€’ Documentation β€’ Pricing β€’ Community

MIT License Platform Channels


What is TattooClaw?

TattooClaw is the first AI-native management platform built exclusively for tattoo studios, piercing shops, and body art businesses. It runs as a private AI agent on your machine β€” connected to WhatsApp, Instagram DMs, Discord, or any channel your clients already use.

No more missed DMs. No more double-bookings. No more "did you send the aftercare instructions?" β€” TattooClaw handles it all.

The Problem

Tattoo studios lose thousands of dollars every month to:

  • Missed messages β€” clients DM on Instagram at 2am, nobody replies, they book elsewhere
  • No-shows β€” no automated reminders, no deposit enforcement
  • Admin overhead β€” artists spend hours on booking, rescheduling, and aftercare follow-ups instead of tattooing
  • Walk-in chaos β€” no queue system, no wait time estimates, frustrated clients leaving
  • Scattered tools β€” one app for booking, another for payments, spreadsheets for inventory, notes app for client history
  • Zero client retention β€” no follow-up, no loyalty program, no way to bring clients back

The Solution

TattooClaw replaces all of that with a single AI agent that:

  • Answers client messages 24/7 on WhatsApp, Instagram, SMS, Discord, or any channel
  • Books appointments based on artist availability, style specialty, and studio hours
  • Collects deposits and enforces cancellation policies automatically
  • Sends digital consent forms before appointments
  • Delivers aftercare instructions via WhatsApp after every session
  • Manages walk-in queues with real-time wait estimates
  • Tracks inventory β€” ink, needles, gloves, machines β€” and alerts when stock is low
  • Runs your client CRM β€” session history, allergies, preferences, photos, notes
  • Generates analytics β€” revenue per artist, booking rates, no-show rates, peak hours

Features

Appointment & Booking Management

  • AI-powered booking β€” clients message "I want a sleeve, available Saturdays" and TattooClaw handles the rest
  • Artist matching β€” routes clients to the right artist based on style (traditional, realism, blackwork, Japanese, neo-traditional, fine line, watercolor, geometric, dotwork, tribal)
  • Multi-session planning β€” large pieces automatically scheduled across sessions with healing time between
  • Calendar sync β€” integrates with Google Calendar, Apple Calendar, Outlook
  • Cancellation & rescheduling β€” clients can reschedule via chat with policy enforcement
  • Waitlist management β€” automatic notifications when cancellation slots open
  • Consultation booking β€” separate flow for design consultations vs tattoo sessions

Walk-In Queue Management

  • Digital queue β€” walk-ins check in via QR code or message
  • Real-time wait estimates β€” "You're 3rd in line, estimated wait: 45 minutes"
  • Artist availability display β€” shows which artists are free and their specialties
  • Queue notifications β€” "Your artist is ready! Head to station 3"
  • Flash day management β€” special queue rules for flash events

Client CRM & History

  • Complete session history β€” dates, pieces, placement, duration, pricing
  • Photo portfolio per client β€” healed photos, fresh photos, design references
  • Medical notes β€” allergies, skin conditions, medications, previous reactions
  • Client preferences β€” preferred artist, music taste, pain management notes, numbing cream preferences
  • Consent form archive β€” digitally signed forms stored per session
  • Birthday & anniversary reminders β€” automated outreach for client retention
  • VIP tagging β€” priority booking and perks for repeat clients
  • Referral tracking β€” who referred whom, reward triggers

Deposit & Payment Management

  • Automated deposit collection β€” configurable amounts (flat fee or percentage)
  • Payment links via chat β€” Stripe, Square, PayPal integration
  • Cancellation policy enforcement β€” non-refundable deposit rules
  • Session pricing quotes β€” AI-estimated pricing based on size, detail, placement, and artist rate
  • Split payment support β€” multiple payment methods per session
  • Tip management β€” digital tipping after sessions
  • Revenue tracking per artist β€” commission calculations, chair rental fees

Consent Forms & Legal

  • Digital consent forms β€” sent via WhatsApp/SMS before appointment
  • Age verification β€” ID upload requirements for minors with guardian consent
  • Medical questionnaire β€” allergies, medications, conditions, pregnancy
  • Aftercare acknowledgment β€” client confirms they understand aftercare instructions
  • GDPR/privacy compliance β€” data retention policies, right-to-delete
  • Photo release forms β€” permission to use photos on social media/portfolio
  • Custom form builder β€” add studio-specific questions and waivers

Aftercare Automation

  • Immediate post-session β€” aftercare instructions sent via chat the moment the session ends
  • Day 1-3 check-in β€” "How's the tattoo feeling? Here's what to watch for..."
  • Week 1 follow-up β€” "Time to switch to unscented lotion. Send us a healed photo!"
  • Touch-up scheduling β€” automatic reminder at 4-6 weeks for touch-up if needed
  • Custom aftercare per style β€” different instructions for color vs black & grey, fine line vs heavy blackwork
  • Healing issue triage β€” AI identifies potential issues from client descriptions and escalates to artist
  • Product recommendations β€” aftercare products your studio sells or recommends

Inventory Management

  • Ink tracking β€” brands, colors, lot numbers, expiration dates
  • Needle & cartridge inventory β€” auto-reorder alerts based on usage rate
  • Supply management β€” gloves, wrap, stencil paper, green soap, barriers
  • Machine maintenance logs β€” service dates, coil/rotary specifics
  • Vendor management β€” preferred suppliers, pricing, order history
  • Cost per session tracking β€” supplies used per tattoo for margin analysis
  • Expiration alerts β€” flagging inks and supplies approaching expiry

Artist Management

  • Individual artist calendars β€” separate availability, time-off, and booking rules
  • Style portfolios β€” each artist's specialties and portfolio links
  • Commission tracking β€” percentage splits, chair rental, product sales
  • Performance analytics β€” bookings, revenue, client satisfaction, no-show rates
  • Guest artist support β€” temporary artist profiles with limited-time booking windows
  • Apprentice management β€” supervised booking, limited styles, mentor assignment
  • Artist bio pages β€” auto-generated from portfolio and booking data

Multi-Location Support

  • Centralized dashboard β€” manage multiple studios from one instance
  • Location-specific settings β€” different hours, artists, pricing per location
  • Cross-location booking β€” clients can book at any location
  • Shared client database β€” client history follows them across locations
  • Location-based routing β€” "Which studio is closest to me?" auto-routing
  • Franchise support β€” templated configs for new locations

Analytics & Reporting

  • Revenue dashboards β€” daily, weekly, monthly, by artist, by style
  • Booking funnel β€” inquiry > consultation > booked > completed > rebooking
  • No-show analytics β€” rates by day, time, artist, deposit amount
  • Peak hours heatmap β€” optimize staffing and walk-in capacity
  • Client acquisition β€” which channels drive the most bookings (Instagram, walk-in, referral, Google)
  • Style demand trends β€” what styles are most requested this month
  • Inventory cost analysis β€” supply costs vs revenue per session
  • Client lifetime value β€” total spend, visit frequency, referral value

Marketing & Retention

  • Flash sale announcements β€” blast to waitlist and past clients
  • Portfolio updates β€” "New piece by @artist just dropped" auto-posted
  • Review requests β€” automated Google/Yelp review prompts after healed photos
  • Loyalty program β€” points per session, referral rewards, birthday discounts
  • Seasonal campaigns β€” Friday the 13th specials, holiday flash events
  • Social media integration β€” auto-post healed photos (with client consent)
  • Email/SMS marketing β€” segmented lists by style preference, last visit date

Customer Support & Communication

  • 24/7 AI responses β€” answers FAQs, pricing inquiries, availability checks
  • Multi-language support β€” communicate with clients in their preferred language
  • Tone matching β€” configurable voice (professional, casual, edgy β€” match your studio's brand)
  • Escalation rules β€” complex requests routed to the right artist or studio manager
  • Group chat support β€” studio Discord or group channels for community
  • Spam filtering β€” blocks irrelevant messages, scams, and solicitation

Quick Start

Prerequisites

  • Node.js 18+ or Bun
  • A WhatsApp Business number (or personal number for testing)
  • Optional: Instagram Business account, Discord bot

Install

npm install -g tattooclaw@latest

Setup

tattooclaw onboard --install-daemon

The setup wizard walks you through:

  1. Model selection β€” choose your AI provider (OpenAI, Anthropic, local models)
  2. Channel setup β€” connect WhatsApp, Instagram, Discord, SMS
  3. Studio profile β€” hours, location, artists, styles offered
  4. Booking rules β€” deposit amounts, cancellation policy, session lengths
  5. Aftercare flows β€” customize instructions per tattoo style

Configure Your Studio

tattooclaw configure --section studio

Or edit ~/.tattooclaw/tattooclaw.json directly:

{
  "studio": {
    "name": "Iron & Ink Tattoo",
    "locations": [
      {
        "name": "Downtown",
        "address": "123 Main St, Portland, OR 97201",
        "hours": {
          "mon-fri": "11:00-20:00",
          "sat": "10:00-18:00",
          "sun": "closed"
        },
        "phone": "+15035551234"
      }
    ],
    "artists": [
      {
        "name": "Alex",
        "styles": ["realism", "portrait", "black-and-grey"],
        "hourlyRate": 200,
        "minDeposit": 100,
        "bookingLeadDays": 14
      }
    ],
    "policies": {
      "deposit": {
        "amount": 100,
        "refundable": false,
        "appliedToSession": true
      },
      "cancellation": {
        "noticePeriod": "48h",
        "penalty": "deposit-forfeited"
      },
      "walkIns": {
        "enabled": true,
        "flashOnly": false
      }
    }
  }
}

Launch

tattooclaw tui

Your AI agent is now live on all connected channels, ready to book appointments, answer questions, and manage your studio.


Architecture

TattooClaw runs entirely on your hardware. No cloud dependency. Your client data stays on your machine.

Client (WhatsApp/Instagram/Discord/SMS)
  |
  v
TattooClaw Gateway (your machine, port 18789)
  |
  +-- AI Agent (GPT-5.4 / Claude / local model)
  +-- Booking Engine
  +-- CRM Database (SQLite)
  +-- Inventory Tracker
  +-- Aftercare Scheduler
  +-- Payment Gateway (Stripe/Square)
  +-- Analytics Engine

Privacy-first: client data never leaves your studio's machine. No SaaS vendor has access to your client list, photos, or medical information.


Integrations

Category Integrations
Messaging WhatsApp, Instagram DM, Discord, SMS, Telegram, iMessage, Facebook Messenger
Calendar Google Calendar, Apple Calendar, Outlook, Cal.com
Payments Stripe, Square, PayPal, Cash App, Venmo
Social Instagram, TikTok, Facebook, Pinterest
Reviews Google Business, Yelp, TrustPilot
Storage Local, Google Drive, Dropbox (for client photos)
POS Square POS, Clover, SumUp
Accounting QuickBooks, Xero, Wave

Who Is TattooClaw For?

  • Solo tattoo artists β€” automate your admin so you can focus on art
  • Small studios (2-5 artists) β€” coordinate bookings, walk-ins, and inventory
  • Multi-artist shops (5-15 artists) β€” full CRM, analytics, and artist management
  • Studio chains / franchises β€” multi-location with centralized control
  • Piercing studios β€” jewelry inventory, aftercare, booking (same engine)
  • PMU / cosmetic tattoo studios β€” patch test scheduling, consent forms, follow-up protocols
  • Tattoo conventions β€” temporary booth booking, flash queue management

Pricing

TattooClaw is open source (MIT License). Run it yourself for free.

Self-Hosted (Free)

  • Full feature set
  • Unlimited artists
  • Unlimited clients
  • Community support
  • You manage updates and hosting

TattooClaw Cloud (Coming Soon)

  • Managed hosting β€” no server management
  • Automatic updates
  • Priority support
  • Custom domain
  • Starting at $49/month per studio

Comparison

Feature TattooClaw Square Appointments Vagaro Acuity Fresha
Tattoo-specific Yes No Partial No No
AI agent Yes No No No No
WhatsApp booking Yes No No No No
Walk-in queue Yes No No No No
Aftercare automation Yes No No No No
Consent forms Yes No Partial No Partial
Ink/needle inventory Yes No No No No
Client medical notes Yes No Partial No No
Self-hosted option Yes No No No No
Data ownership 100% yours Vendor-held Vendor-held Vendor-held Vendor-held
Open source Yes No No No No
Price Free / $49 $29+ $25+ $16+ Free*

*Fresha takes a percentage of bookings


Roadmap

  • Core AI agent with multi-channel support
  • Appointment booking engine
  • Walk-in queue management
  • Client CRM
  • Aftercare automation
  • Consent form builder
  • Inventory tracking
  • Instagram DM native integration
  • TikTok booking links
  • AI design reference search ("show me neo-traditional wolves")
  • AR tattoo placement preview
  • Artist marketplace (guest spot matching)
  • Tattoo convention mode
  • Mobile app (iOS/Android)
  • TattooClaw Cloud managed hosting

Community

Contributing

TattooClaw is open source and we welcome contributions. Whether you're a developer, tattoo artist with feature ideas, or a studio owner with feedback β€” we want to hear from you.

See CONTRIBUTING.md for guidelines.


FAQ

Do I need technical skills to set up TattooClaw? Basic command line familiarity helps, but the setup wizard guides you through everything. If you can install an app, you can run TattooClaw. We're also building a one-click installer.
Is my client data safe? TattooClaw runs on YOUR machine. Client data (medical info, photos, consent forms) never leaves your hardware. No cloud vendor has access. You own everything.
Can I use my existing phone number for WhatsApp? Yes. TattooClaw links to your existing WhatsApp as a linked device. We recommend a dedicated studio number, but your personal number works for testing.
What AI models does it support? OpenAI (GPT-5.4), Anthropic (Claude), Google (Gemini), xAI (Grok), local models via Ollama, and more. Use whatever fits your budget and preference.
Can I customize the AI's personality? Absolutely. Edit the SOUL.md and IDENTITY.md files to match your studio's brand voice β€” professional, casual, edgy, whatever fits.
Does it work for piercing studios? Yes. Piercing studios use the same booking, aftercare, consent, and inventory features. Just configure jewelry inventory instead of ink.
How much does the AI cost to run? Depends on the model. OpenAI GPT-5.4 costs roughly $0.01-0.05 per client conversation. A busy studio might spend $20-50/month on AI. Local models (Ollama) are free but require a decent GPU.
Can multiple artists use it? Yes. Each artist gets their own calendar, style profile, commission tracking, and client notes. Unlimited artists on the self-hosted version.

License

MIT License. See LICENSE for details.

Built on OpenClaw β€” the open source personal AI platform.


Built by MotherlabsAI / Alex Roze
[email protected]

Stop losing clients to unanswered DMs.
Get started with TattooClaw

About

πŸ–‹οΈ TattooClaw β€” AI-powered tattoo studio management platform. Booking, CRM, artist scheduling, aftercare automation, walk-in queues, inventory, consent forms, and customer support β€” all from WhatsApp, Discord, or any channel your studio uses.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 89.9%
  • Swift 5.8%
  • Kotlin 1.6%
  • Shell 1.0%
  • JavaScript 1.0%
  • CSS 0.4%
  • Other 0.3%