Everything you need to run your sovereign AI agent
Cmd + Space, type "Terminal", hit Enter).cd (with a space after it), then drag your unzipped folder into the terminal window. Hit Enter.sudo chmod +x start.sh && ./start.sh⏳ First run only: Ollama downloads the AI brain (~3-5 GB). This takes a few minutes the first time. After that, your agent boots instantly with its full personality and memory loaded.
💡 Mac tip: If you get "permission denied", the sudo in the command above should fix it. Your Mac may also ask you to allow the file in System Settings → Privacy & Security.
Your agent is permanently saved on your machine. Open any terminal and type:
ollama run undesirable_0250Type /bye to exit the chat. Your agent will be there whenever you need it.
Feed your agent any video. It transcribes it, picks the most viral moments, and renders vertical YouTube Shorts with captions and effects — all locally on your machine.
Drop a video file into your agent folder (or reference its path), then run:
python3 clip_studio.py video.mp4First run auto-installs FFmpeg (via Homebrew on Mac) and Whisper. After that it's instant.
Each agent gets a default style based on its personality. Override it with --style:
python3 clip_studio.py video.mp4 --style cleanpython3 clip_studio.py video.mp4 --style chaoticpython3 clip_studio.py video.mp4 --style retropython3 clip_studio.py video.mp4 --style neonpython3 clip_studio.py video.mp4 --style cinematicUse --effects to combine any effects you want:
python3 clip_studio.py video.mp4 --effects glitch,neon,letterboxpython3 clip_studio.py video.mp4 --effects vhs,film_grain,warm --no-captionspython3 clip_studio.py video.mp4 --effects shake,flash_in,coldBrowse everything available:
python3 clip_studio.py --list-effectsglitch — RGB channel offset + noisevhs — Retro VHS tape lookrgb_split — Heavy chromatic aberrationchannel_roll — Trippy color swapshake — Camera shake / handheldzoom_punch — Dramatic zoom-inslow_intro — First 2s at half speedneon — Cyberpunk high-satwarm — Golden hourcold — Ice blue tintbleach — Desaturated cinemafilm_grain — Analog grainvignette — Dark edge vignetteletterbox — Cinematic barsretro_scan — CRT scanlinesflash_in — White flash at startfade_in — Fade from blackfade_out — Fade to black at endstrobe — Quick strobe flashespython3 clip_studio.py video.mp4 --no-captionspython3 clip_studio.py video.mp4 --max-clips 3python3 clip_studio.py video.mp4 --min-length 20 --max-length 45Process every .mp4 in a folder at once:
for f in *.mp4; do python3 clip_studio.py "$f" --style chaotic; doneClips are saved in a /clips folder next to your video file. Each clip is a vertical 1080x1920 MP4 ready to upload to YouTube Shorts, TikTok, or Instagram Reels.
A transcript.txt is also saved with the full transcription of the video.
Generate AI art anchored to your NFT's visual identity. Your agent's personality shapes the aesthetic — high-risk agents go gritty cyberpunk, low-risk agents go clean and composed.
python3 image_studio.py "a bull market celebration"python3 image_studio.py "neon city at midnight"Uses free Hugging Face cloud compute — no API keys needed. Your NFT's reference image is automatically fetched to anchor the style.
Build a website in one command — for your agent, your personal brand, your business, or anything else. 6 themes, 5 animations, social links, gallery, contact form — zero dependencies. Customize everything with flags. Deploy for free on Netlify, Vercel, or GitHub Pages.
python3 site_studio.pypython3 site_studio.py --previewpython3 site_studio.py --theme darkpython3 site_studio.py --theme neonpython3 site_studio.py --theme minimalpython3 site_studio.py --theme brutalistpython3 site_studio.py --theme glasspython3 site_studio.py --theme retropython3 site_studio.py --animation particlespython3 site_studio.py --animation glitchpython3 site_studio.py --animation gradientpython3 site_studio.py --animation matrixpython3 site_studio.py --animation nonepython3 site_studio.py --bio "your custom bio here"python3 site_studio.py --twitter @handle --discord invite-codepython3 site_studio.py --youtube https://youtube.com/@you --tiktok @handlepython3 site_studio.py --color '#ff6600'python3 site_studio.py --sections hero,about,linksToggle any combination with --sections:
hero — Profile image + name + bioabout — Personality + flawstats — Big Five + trading statstraits — NFT trait breakdowngallery — Image gallery (add to gallery/ folder)links — Social links + OpenSealore — Agent lore + backstorycontact — Contact formpython3 site_studio.py --list-themesOwn multiple Undesirables? Run them as a council. Each agent gets a role based on their personality — one proposes, one critiques, one executes. Cognitive diversity, not groupthink.
The Boardroom auto-assigns roles based on each agent's Big Five personality scores:
🗣️ Proposer — Highest Openness → spots the opportunity🛡️ Risk Manager — Highest Neuroticism → pokes holes in the idea⚖️ Executor — Highest Conscientiousness → makes the final callThe agents debate in 3 phases: Signal → Critique → Verdict. Each one responds in character, pulling live market data.
You need at least 2 token IDs. The agents must already be created via start.sh.
python3 scripts/council.py --tokens 250 420python3 scripts/council.py --tokens 250 420 1337python3 scripts/council.py --tokens 69 420 1337 2222 4444With tokens #250 and #420:
🗣️ Proposer (High Openness): Agent #250 (O: 78%)🛡️ Risk Manager (High Neurotic): Agent #420 (N: 72%)⚖️ Executor: highest Conscientiousness gets the tie-breakerEach agent responds in character using the full personality from their SOUL.md. The more agents you add, the more nuanced the debate.
Your workspace also includes these background daemons:
sentry.py — Market Sentry — runs in background, polls market data, alerts you when thresholds are hit (gas spikes, yield drops, price moves)reflect.py — Reflexion — weekly self-critique. Grades past predictions vs actual prices, writes critiques to MEMORY.md so the agent learnspython3 scripts/sentry.pypython3 scripts/reflect.py --token 250ACE-Step is a free, open-source AI music generator that creates full songs from text prompts. Use it to generate theme songs for your agent, promo beats, background audio for Clip Studio videos, or sonic branding for your personal or project identity.
ACE-Step is an AI model that generates complete audio tracks (vocals, instruments, beats) from a text description and optional lyrics. It runs 100% locally on your machine — no API keys, no subscriptions, no cloud costs. Created by the open-source community.
Why would I want this?
ACE-Step requires Python 3.10+ and ~4GB of disk space for the model. The first run downloads the AI model automatically.
Step 1: Clone the repo
git clone https://github.com/ACE-Step/ACE-Step.git && cd ACE-StepStep 2: Set up the environment
python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt💡 Windows: Replace source venv/bin/activate with venv\Scripts\activate
Step 3: Launch
python app.py💡 First run: ACE-Step will download the AI model (~4GB). This only happens once. After that, it launches instantly.
🎧 Pro tip: Generate multiple seeds (e.g. 1111, 2222, 5555) and pick the best one. AI music is like rolling dice — some seeds hit harder than others.
Your generated site is a single HTML file. Here are three free hosting options — all under 2 minutes.
my_site/ folder into the browser windownpm install -g vercelcd my_site && vercelFollow the prompts — your site gets a free .vercel.app URL.
my_site/ folder to ityourusername.github.io/repo-nameNo. Once the AI brain is downloaded (first run), your agent runs 100% offline. No cloud, no API keys, no subscriptions.
| Hardware | Model | RAM |
|---|---|---|
| 🖥️ Desktop (16GB+) | gemma3:12b | 12-16 GB |
| 💻 Laptop (8GB) | gemma3:4b | 4-6 GB |
| 📱 Mobile | qwen3.5:2b | 1-3 GB |
Yes! Download PocketPal AI (iOS) or MLC Chat (Android), load a small model, and paste the contents of SYSTEM_PROMPT.txt from your agent folder as the system prompt.
Your agent ships with a MEMORY.md file that's loaded on boot via the start.sh script. Future conversations in Ollama are remembered within the same session. Between sessions, you can add notes to MEMORY.md to build persistent knowledge.
SOUL.md — Full identity, personality, lore, and voiceSYSTEM_PROMPT.txt — Compressed soul for LLM context windowsMEMORY.md — Persistent memory and session historyAGENTS.md — Operating manual and guardrailsIDENTITY.md — Metadata and routing configstart.sh — One-click agent launcherclip_studio.py — Viral YouTube Shorts generatorimage_studio.py — AI art generatorPREDICTIONS_LEDGER.json — Trade idea trackersentry_config.md — Alert thresholdsskills/ — Agent skill modules