Skip to main content
Glama
README.md
<p align="center">
  <img src="docs/brand/icon.png" width="160" height="160" alt="Scrapbook/01 icon: a white molded device with a dark screen showing a small graph of linked saves, and an orange S/01 nameplate">
</p>

<h1 align="center">Scrapbook/01</h1>

<p align="center">
  <b>Share things to yourself, and find them again.</b><br>
  Save reels, TikToks, videos and links from any app with one line about what they are.<br>
  They sort themselves into categories and link up into a graph you can browse.
</p>

<p align="center">
  <a href="https://d2gh6vwoycfx90.cloudfront.net"><b>Join the waitlist</b></a> for the hosted app,
  or <a href="docs/self-hosting.md"><b>host your own copy</b></a> on AWS. Whichever you like.
</p>

<p align="center">
  <a href="https://github.com/franco-roura/scrapbook-01/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/franco-roura/scrapbook-01/ci.yml?branch=main&style=flat-square&label=CI"></a>
  <a href="https://github.com/franco-roura/scrapbook-01/releases"><img alt="Latest release" src="https://img.shields.io/github/v/release/franco-roura/scrapbook-01?style=flat-square&color=53575e"></a>
  <img alt="Go" src="https://img.shields.io/badge/API-Go-1c1e21?style=flat-square&logo=go">
  <img alt="Expo" src="https://img.shields.io/badge/app-Expo%20%2F%20React%20Native-1c1e21?style=flat-square&logo=expo">
  <img alt="MCP" src="https://img.shields.io/badge/AI-MCP%20server-1c1e21?style=flat-square">
  <a href="https://d2gh6vwoycfx90.cloudfront.net"><img alt="Waitlist open" src="https://img.shields.io/badge/waitlist-open-ffd9c7?style=flat-square"></a>
  <a href="docs/self-hosting.md"><img alt="Self-host on AWS" src="https://img.shields.io/badge/or%20self--host-AWS%20Lambda-1c1e21?style=flat-square"></a>
  <img alt="License: MIT OR Apache-2.0" src="https://img.shields.io/badge/license-MIT%20%2F%20Apache--2.0-53575e?style=flat-square">
</p>

<p align="center">
  <img src="docs/brand/hero.png" alt="Three Scrapbook/01 screens, in Spanish: the share sheet asking '¿De qué se trata?' (what is it about?), the library with saves filed into categories like Viaje a Japón and Cenas de semana, and an item's connections drawn as a small graph" width="880">
</p>

The app and the website are in Uruguayan Spanish; the code and these docs are in English.

## Contents

- [Two ways to use it](#two-ways-to-use-it)
- [Why Scrapbook/01](#why-scrapbook01)
- [Share it, say what it's about](#share-it-say-what-its-about)
- [It sorts itself, for a fraction of a cent](#it-sorts-itself-for-a-fraction-of-a-cent)
- [A graph of everything you saved](#a-graph-of-everything-you-saved)
- [Ask your own AI about it](#ask-your-own-ai-about-it)
- [Host your own, for cents](#host-your-own-for-cents)
- [Run it locally in five minutes](#run-it-locally-in-five-minutes)
- [Status](#status)
- [Who's behind it](#whos-behind-it)
- [Contributing](#contributing)
- [Security and license](#security-and-license)

## Two ways to use it

<table>
  <tr>
    <td width="50%" valign="top">
      <b>Use the hosted app</b><br>
      We run Scrapbook/01 for you. Sign-up opens in waves: leave your email on the
      <a href="https://d2gh6vwoycfx90.cloudfront.net">landing page</a> and you'll get an invitation.
      Sorting and AI are paid from prepaid credits, and new accounts start with some free.
    </td>
    <td width="50%" valign="top">
      <b>Host your own</b><br>
      The same app in your own AWS account, with your own WorkOS and AI keys. It scales to zero,
      so one person's month is about two cents of hosting.
      <a href="docs/self-hosting.md">Self-hosting guide →</a>
    </td>
  </tr>
</table>

## Why Scrapbook/01

<table>
  <tr>
    <td width="50%" valign="top">
      <b>Better than messaging yourself</b><br>
      Share from Instagram, TikTok, YouTube or X straight into your library, instead of a chat with
      yourself where things sink. <a href="docs/features.md">Features →</a>
    </td>
    <td width="50%" valign="top">
      <b>Your words, not a scraper</b><br>
      You type one line about what it is, and that's what sorting reads. The link's public preview
      (title and picture) is only shown on the card, so it works for every app and stays accurate.
      <a href="docs/features.md#saving">Saving →</a>
    </td>
  </tr>
  <tr>
    <td valign="top">
      <b>Files itself</b><br>
      A small classifier picks one of your categories. Only when nothing fits does Claude Haiku name a
      new one. <a href="docs/sorting.md">How sorting works →</a>
    </td>
    <td valign="top">
      <b>Browse it like Obsidian</b><br>
      Similar saves link up. Open any item to see its neighbors, and hop from one to the next.
      <a href="docs/features.md#the-graph">The graph →</a>
    </td>
  </tr>
  <tr>
    <td valign="top">
      <b>Your AI, your tokens</b><br>
      Connect Claude or ChatGPT over MCP. Their reasoning runs on your own plan; the server only does
      cheap retrieval. <a href="docs/ai-assistants.md">AI assistants →</a>
    </td>
    <td valign="top">
      <b>Costs cents to host</b><br>
      Two Go Lambdas, static sites on CloudFront and Postgres on Neon, all scaling to zero.
      <a href="docs/architecture.md#what-it-costs">Costs →</a>
    </td>
  </tr>
</table>

## Share it, say what it's about

Tap Share in any app and pick Scrapbook/01. A small sheet opens on top of the app you're in, with the
link filled in and the keyboard up on one question: "¿De qué se trata?" (what is it about?). Type a few words (or dictate
them) and tap Save. Skipping is fine too: undescribed saves wait in an inbox.

**[Read more: the features tour →](docs/features.md)**

## It sorts itself, for a fraction of a cent

Each description goes to [Jev](https://typesafe.ai), which picks one of your existing categories,
described by what you already put in them. Only when nothing fits does Claude Haiku name a new
category, in the language you wrote in. A notification says where it went, and you can move it.
Sorting a save costs about $0.000014; naming a new category about $0.0002.

**[Read more: how saves get sorted →](docs/sorting.md)**

## A graph of everything you saved

Every save is embedded once and linked to its closest neighbors with pgvector. The graph view draws
your whole library, with category hubs in Module/01's colors and similar saves linked. Each item shows
its connections one or two hops out; tap one to move there while the layout stays put.

<p align="center">
  <img src="docs/screenshots/graph-wide.png" alt="The map view: six category hubs (Cenas de semana, Viaje a Japón, Crianza, Rutinas en casa, Inspiración de diseño, Libros para leer), each surrounded by the saves filed into it, with similar saves linked" width="880">
</p>

**[Read more: the graph →](docs/features.md#the-graph)**

## Ask your own AI about it

Scrapbook/01 is an MCP server. Add it to Claude or ChatGPT as a connector, sign in, and ask "what was
that ramen place in Tokyo I saved?". It can search your library, open items and their neighbors, and
save new links. Your assistant's reasoning is billed to your own plan, not to Scrapbook/01.

**[Read more: AI assistants →](docs/ai-assistants.md)**

## Host your own, for cents

Prefer your own copy? Everything here deploys to your AWS account with one command. The API and the
sorting worker are Go Lambdas behind API Gateway, the web app and landing page are static sites on
CloudFront, and Postgres runs on Neon, which scales to zero. With nobody using it,
nothing is billed. One person's month comes to about two cents of hosting; the AI calls are paid from
prepaid credits.

<p align="center">
  <a href="docs/architecture.md"><img src="docs/brand/architecture.png" alt="Deployment map: phones, browsers and AI assistants reach API Gateway and the Go API Lambda in your AWS account, which invokes a worker Lambda to sort saves; EventBridge runs an hourly sweep; CloudFront serves the web app from S3. Neon Postgres, WorkOS AuthKit, the AI models and Expo Push are hosted elsewhere. Each part is labeled with its monthly cost, about two cents in total." width="880"></a>
</p>

**[Read more: architecture and costs →](docs/architecture.md)** ·
**[Host it yourself →](docs/self-hosting.md)**

## Run it locally in five minutes

You need Go, Bun and Docker, plus a free [WorkOS](https://workos.com) sandbox for sign-in. Postgres
runs in Docker, and a fake AI server stands in for Jev, the embeddings API and Claude, so the whole
save, sort and link flow works without any AI keys.

**[Read more: getting started →](docs/getting-started.md)**

## Status

Early, and built in the open: the current release is
[v0.1.0](https://github.com/franco-roura/scrapbook-01/releases). The Go API, the MCP server, sorting, credits and the web app are tested
and run locally, and the hosted app runs on AWS behind the waitlist. Not yet proven on real hardware:
the iOS share extension and push notifications on a device. Payments for credit packs aren't connected
yet (packs can be granted by hand for now). Issues and pull requests are welcome.

## Who's behind it

Scrapbook/01 is built by its cofounders, [Franco Roura](https://github.com/franco-roura) and
[Alexis Augoustis](https://github.com/aaugoustis). It started as Alexis's waitlist page in
[aaugoustis/waitlist](https://github.com/aaugoustis/waitlist) and moved here as the app grew; the full
history came along.

## Contributing

Bug reports, fixes and ideas are all welcome. The app is Expo (React Native) styled with the
[Module/01](https://github.com/franco-roura/module-01) design system; the API is Go with sqlc and
River. Every pull request adds a changeset, which becomes its line in the
[changelog](CHANGELOG.md), and everyone taking part follows the [code of conduct](CODE_OF_CONDUCT.md).

**[Read more: CONTRIBUTING.md →](CONTRIBUTING.md)** · **[Local development →](docs/development.md)**

## Security and license

Report security issues privately as described in [SECURITY.md](SECURITY.md).

Dual-licensed under either of [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE), at your option.