AI-powered content distribution for startups. Write one brief, get platform-native content for 8 channels — LinkedIn, X/Twitter, Reddit, Facebook, Email, YouTube, Instagram, and TikTok — generated instantly by Claude AI.
Distro gives small teams the distribution power of a full marketing department:
- Set your voice — Paste your website URL and Distro auto-extracts your brand voice, tone, and style. Edit it to your liking.
- Write a brief — Describe what you want to say (e.g., "We just hit 1,000 customers — share the milestone authentically").
- Generate — Claude AI creates tailored content for all 8 platforms in seconds, each adapted to the platform's culture, format, and character limits.
- Review & post — Edit any post on its dedicated detail page, preview how it looks, and post with one click.
- Schedule — Set recurring posting schedules with default briefs, and override specific days with custom campaign content.
You need two things installed on your computer before starting:
- Node.js (version 18 or higher)
- Git (to download the code)
Open your Terminal (Mac) or Command Prompt (Windows) and type these commands:
node --versionYou should see something like v18.17.0 or v20.11.0. Any number 18 or higher is fine.
git --versionYou should see something like git version 2.39.0.
- Go to https://nodejs.org
- Click the big green button that says "LTS" (Long Term Support)
- Download and run the installer
- Follow the prompts — just click "Next" / "Continue" through everything
- When it's done, close and reopen your Terminal, then try
node --versionagain
- Go to https://git-scm.com/downloads
- Download the installer for your operating system
- Run the installer with default settings
- Close and reopen your Terminal, then try
git --versionagain
Open your Terminal and run:
git clone https://github.com/Risus-Pieces/distro.gitThen navigate into the project folder:
cd distroThis downloads all the libraries the app needs. Run:
npm installThis may take 1-2 minutes. You'll see a progress bar. Wait until it finishes and you see your cursor again.
Distro uses Claude AI to generate content. You need an Anthropic API key.
- Go to https://console.anthropic.com and sign up (or log in)
- Navigate to API Keys in the sidebar
- Click Create Key and copy the key (it starts with
sk-ant-...)
Now create a file called .env.local in the project folder. You can do this from the Terminal:
On Mac/Linux:
echo 'ANTHROPIC_API_KEY=paste-your-key-here' > .env.localOn Windows (Command Prompt):
echo ANTHROPIC_API_KEY=paste-your-key-here > .env.localReplace paste-your-key-here with the actual API key you copied.
Note: The
.env.localfile is already in.gitignore, so your key will never be uploaded to GitHub.
Run:
npm run devYou should see output like:
▲ Next.js 16.2.2
- Local: http://localhost:3000
Open your web browser (Chrome, Safari, Firefox, etc.) and go to:
You should see the Distro dashboard with the logo, sidebar, and the voice profile form.
- Expand the Voice Profile card on the left
- Paste your website URL into the "Auto-fill from website" field and click Analyze — Claude will extract your brand voice automatically
- Review and edit the fields: brand name, what you do, tone tags, "never say" words, and "sounds like" description
- In the Brief section below the voice profile, describe what you want to announce or share
- Click Generate
- After generation, the right panel shows cards for all 8 platforms
- Click any card to go to its detail page where you can:
- Edit the generated content
- See a live preview of how it will look on that platform
- Upload images (LinkedIn) or videos (YouTube, Instagram, TikTok)
- Post to the platform
- Click Calendar in the sidebar to view the posting schedule
- From any platform's detail page, click Schedule to set up recurring posts
- On the calendar, click any day to add a campaign override with a custom brief
To stop the app, go back to your Terminal and press:
Ctrl + C
This shuts down the development server.
Whenever you want to run Distro again:
- Open your Terminal
- Navigate to the project folder:
cd distro(or wherever you saved it) - Run:
npm run dev - Open http://localhost:3000 in your browser
You do not need to run npm install again — only the first time.
| Problem | Solution |
|---|---|
node: command not found |
Node.js isn't installed. Follow the install instructions above. |
npm: command not found |
npm comes with Node.js. Reinstall Node.js from nodejs.org. |
git: command not found |
Git isn't installed. Follow the install instructions above. |
| The page is blank or shows an error | Make sure you created the .env.local file with your API key. Restart the server with Ctrl+C then npm run dev. |
| "Generation failed" error | Your Anthropic API key may be invalid or out of credits. Check console.anthropic.com. |
| Port 3000 is already in use | Another app is using that port. Run npm run dev -- -p 3001 and open http://localhost:3001 instead. |
- Next.js — React framework
- TypeScript — Type-safe JavaScript
- Tailwind CSS — Styling
- Claude AI (Anthropic API) — Content generation and brand voice analysis
- Resend — Email delivery
- LinkedIn, Twitter, Reddit APIs — Social media posting