Repolode
Submit
dimkr

dimkr/tootik

A federated, text-based social network served over the Gemini protocol, interoperating with ActivityPub servers like Mastodon.

View on GitHub
Stars
211
Forks
7
Open issues
21
Last commit
10 hours ago

What is it?

tootik is a social network with a text-only interface served over Gemini instead of a web browser or app. It federates through ActivityPub, so users on the same instance can interact with users on compatible servers such as Mastodon, Lemmy, Friendica and GoToSocial.

Accounts authenticate with TLS client certificates, so users do not need to provide an email address or real name. The server is written in Go and stores all instance data in a single SQLite database, and it ships as a single static executable that is easy to back up and update. The codebase implements only the part of ActivityPub needed for its feature set.

Features include text posts with public, follower-only and mention-only visibility, polls, Lemmy-style communities, bookmarks, full-text search, and portable accounts across servers using FEP-ef61. Invite-only registration and automatic deletion of old posts are also supported.

Key features

  • 01Gemini-based text interface that works with a range of Gemini clients
  • 02ActivityPub federation with Mastodon, Lemmy and other compatible servers
  • 03Posts with public, follower-only or mention-only visibility
  • 04Lemmy-style communities, polls, bookmarks and full-text search
  • 05Single static executable with all data in one SQLite file

Use cases

  • Running a small private or invite-only social network on a low-cost VPS or single-board computer
  • Participating in the fediverse through a text-only, low-bandwidth interface
  • Studying a compact ActivityPub server implementation written in Go

Quick start

  1. 1

    Generate the database migrations

    go generate ./migrations
  2. 2

    Build the tootik executable

    go build ./cmd/tootik -tags fts5
  3. 3

    Read SETUP.md to configure and run your own instance

Things to know

  • It has no browser or app interface, so users must use a Gemini client.
  • Building from source requires a Go toolchain and a code generation step first.

In collections

Self-hosted appsDatabases & SQL tools

Topics

#activitypub#fediverse#gemini#social-network#golang#sqlite#self-hosted#activitypub-server#gemini-protocol#gemini-server

FAQ

What is tootik?
A federated, text-based social network served over the Gemini protocol, interoperating with ActivityPub servers like Mastodon. tootik is a social network with a text-only interface served over Gemini instead of a web browser or app. It federates through ActivityPub, so users on the same instance can interact with users on compatible servers such as Mastodon, Lemmy, Friendica and GoToSocial.
Is tootik free to use? What license does it have?
tootik is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is tootik still maintained?
Actively maintained. The last commit to tootik was on Nov 7, 2026.
What can I use tootik for?
Running a small private or invite-only social network on a low-cost VPS or single-board computer Participating in the fediverse through a text-only, low-bandwidth interface Studying a compact ActivityPub server implementation written in Go
How do I install tootik?
Generate the database migrations: go generate ./migrations Build the tootik executable: go build ./cmd/tootik -tags fts5 Read SETUP.md to configure and run your own instance
Where can I get tootik?
The source code and installation instructions are on GitHub: https://github.com/dimkr/tootik

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects