What is slack-assets-bot?

slack-assets-bot is a personal Slack bot that turns your Slack direct messages into an organized file library on your own machine. The idea is simple: instead of hunting through downloads folders or browser histories for a meme, clip, or sound you saved weeks ago, you drop files and links into a Slack DM and the bot automatically files them into category folders, screenshots, photos, videos, sounds, and more, on your computer. When you send the bot a file, it looks at the file type and routes it to the right folder. Images go through a classifier that distinguishes screenshots from photos. YouTube links are downloaded as both a video file (.mp4) and an audio file (.mp3). Direct URLs to images, videos, or audio work too, web pages are ignored. You can rename a file on the fly by typing something like "name: kanye_laugh" in the same message, and the bot saves it under that name with the correct extension added automatically. You can also tag assets to a specific project, typing "project: kanye-launch" in the message routes the file into a per-project subfolder instead of the top-level category folder, letting you build organized bundles for a particular video or campaign without extra steps. Optionally, if you have the Claude Code CLI installed, the bot uses Claude's vision capability to auto-generate descriptive filenames for images with generic names, turning something like "CleanShot_2026.png" into "team_dashboard.png", so files stay discoverable by name for you or other automated tools later. The bot is built in Python 3.10+, requires yt-dlp and ffmpeg for downloading YouTube content, and runs against a Slack workspace where you install it as a custom app.