Quickstart — Archive, Sync, Harmonize, and Publish
In this tutorial you’ll install Otso and pick a simple place to begin.
Install prerequisites
Section titled “Install prerequisites”- Node.js 18+
- pnpm
Then install:
pnpm install -g otsoInitialize workspace
Section titled “Initialize workspace”otso init mysitecd mysiteChoose your path
Section titled “Choose your path”After setup, try one of these common tasks:
Archive a Twitter/X export and publish to your own site
Section titled “Archive a Twitter/X export and publish to your own site”Save a local copy of your tweets then publish them on your site.
otso import twitter --archive ~/Downloads/twitterotso publish siteSee Import Twitter/X Archive for details.
Automatically sync your Mastodon posts, likes, and replies to your website and local storage
Section titled “Automatically sync your Mastodon posts, likes, and replies to your website and local storage”Run this as a PESOS job—like Bridgy or Echofeed—to pull your Mastodon activity into your local archive and mirror it to your site. You can run it locally on demand or deploy it as a scheduled job on a serverless or cron service.
otso import mastodon --include likes,replies --since 7dotso publish siteDeploy a recurring import every 15 minutes on Vercel:
otso run --every 15m --on vercel import mastodon --include likes,repliesMore options in Import from Mastodon.
Publish a note on your website and cross-post it to Bluesky and Mastodon
Section titled “Publish a note on your website and cross-post it to Bluesky and Mastodon”Send a post to your site, Bluesky, and Mastodon at once.
otso publish hello.md --to bluesky,mastodonFollow Publish via Micropub, Publish to Bluesky, and Publish to Mastodon to configure endpoints.
Tag your bookmarks from Pinboard and Readwise using a local AI model
Section titled “Tag your bookmarks from Pinboard and Readwise using a local AI model”Import bookmarks then enrich them with tags from a local model.
otso import pinboard --since 30dotso import readwise --since 30dotso enrich tags --model localSee Import Bookmarks & Enrich with Defuddle for more on cleaning up bookmarks.
Generate searchable descriptions from your screenshots folder
Section titled “Generate searchable descriptions from your screenshots folder”Pull images from a folder, auto‑caption them, then search by description.
otso import folder ~/Pictures/Screenshotsotso enrich describe --model localSearch later and see matches highlighted:
otso search "concert ticket" --images~/Pictures/Screenshots/live-show.png — “July 4 concert ticket”
Visualize your music listening across sites
Section titled “Visualize your music listening across sites”Combine listening history from multiple services into one timeline.
otso import lastfm --since 30dotso import spotify --since 30dotso view music-timelineAsk questions of your Notion docs using a local AI model
Section titled “Ask questions of your Notion docs using a local AI model”Pull your Notion pages and ask them questions offline.
otso import notion --database my-notesotso ask "When is the next team meeting?" --model localMigrate Pinboard bookmarks to Raindrop with a searchable local copy
Section titled “Migrate Pinboard bookmarks to Raindrop with a searchable local copy”Move your links to Raindrop while keeping everything indexed locally.
otso import pinboard --allotso export raindropotso search "pasta recipe" --bookmarksPick another path anytime—Otso lets you roam.