How jj-sleeps/paletteai works
PaletteAI’s main workflow is image upload or sample selection, image normalization and palette extraction, then palette review, accessibility/visualization, and library or feedback-based ranking. Its plugin framework adds local and webhook panels; the separate cross-dev Palette Fixer receives VibeCheck events and suggests (but does not apply) palette swaps. Edges reflect shown calls and README-documented behavior; unsampled implementation details are not inferred.
Main entry points: api.py REST API · service.py Palette services · main.py App factory · plugins.py Plugin manager
Components 20
PaletteAI app
- App factory
paletteai/main.py - REST API
paletteai/api.py - API models
paletteai/schemas.py - Web interface
paletteai/static/app.js - Runtime settings
paletteai/config.py - Palette services
paletteai/service.py - SQLite store
paletteai/db.py - Sample images
paletteai/samples.py
Palette analysis
- Image normalization
paletteai/etl.py - Palette clustering
paletteai/clustering.py - Color science
paletteai/color.py - Preference ranking
paletteai/ranking.py
Plugins
- Plugin manager
paletteai/plugins.py - Tints and shades
plugins/tints_and_shades/plugin.py - Webhook plugin
Palette Fixer
- Fixer webhook app
crossdev/palette_fixer/app.py - Swap engine
crossdev/palette_fixer/fixer.py - VibeCheck client
crossdev/palette_fixer/client.py
Other components
- User
- VibeCheck host
Connections 25
- User → Web interface: uses
README.md - Web interface → REST API: calls API
README.md - App factory → Runtime settings: loads settings
paletteai/main.py - App factory → SQLite store: initializes
paletteai/main.py - App factory → Sample images: creates samples
paletteai/main.py - App factory → REST API: mounts router
paletteai/main.py - App factory → Plugin manager: loads plugins
paletteai/main.py - REST API → API models: validates with
paletteai/api.py - REST API → Palette services: calls
paletteai/api.py - REST API → Sample images: lists samples
paletteai/api.py - Palette services → Image normalization: normalizes images
paletteai/service.py - Palette services → Palette clustering: extracts clusters
paletteai/service.py - Palette services → Color science: computes color data
paletteai/service.py - Palette services → Preference ranking: ranks palettes
paletteai/service.py - Palette services → SQLite store: reads and writes
paletteai/service.py - REST API → Color science: runs color tools
paletteai/api.py - REST API → SQLite store: queries previews
paletteai/api.py - Plugin manager → Tints and shades: loads plugin
paletteai/plugins.py - Plugin manager → Webhook plugin: dispatches panels
paletteai/plugins.py - Plugin manager → Palette services: provides palette access
paletteai/plugins.py - VibeCheck host → Fixer webhook app: sends event
crossdev/palette_fixer/app.py - Fixer webhook app → Swap engine: proposes swaps
crossdev/palette_fixer/app.py - Fixer webhook app → VibeCheck client: fetches and rescoring
crossdev/palette_fixer/app.py - VibeCheck client → VibeCheck host: calls host API
- Swap engine → Color science: uses color science
crossdev/palette_fixer/fixer.py