explaingit

blinkospace/blinko

10,372TypeScriptAudience · generalComplexity · 3/5Setup · moderate

TLDR

Blinko is a self-hosted note-taking app where you capture quick Markdown notes and find them later with AI-powered plain-language search, your notes stay on your own server, not someone else's cloud.

Mindmap

mindmap
  root((repo))
    What it does
      Quick note capture
      Markdown formatting
      AI-powered search
    AI search
      Plain language queries
      RAG matching
    Deployment
      Docker single command
      PikaPods managed
      macOS Windows Linux Android
    Data storage
      PostgreSQL
      Self-hosted only
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Deploy Blinko with a single Docker command and get a private AI-searchable note-taking app on your own server.

USE CASE 2

Search your notes by typing a question in plain language instead of exact keywords, powered by AI matching.

USE CASE 3

Deploy Blinko through PikaPods for a managed self-hosted experience without managing server infrastructure yourself.

Tech stack

TypeScriptNext.jsReactPostgreSQLDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker on your server, PostgreSQL is provisioned automatically as part of the Docker deployment.

In plain English

Blinko is a personal note-taking application you run on your own server, built for people who want to capture quick thoughts or ideas without those notes being stored on someone else's platform. Because you host it yourself, your data stays under your control and is not shared with any third-party service. The app centers on a card-style interface where notes can be written in Markdown, a simple text formatting system that lets you add headings, bold text, and lists without needing a visual editor. One of its main features is AI-assisted search: rather than typing exact keywords, you can ask questions in plain language and Blinko will pull up relevant notes using a technique called RAG (Retrieval-Augmented Generation), which matches your query against the content of your notes. Blinko runs on macOS, Windows, Linux, and Android. It can be installed on a server in seconds using Docker, with a single command that handles the setup automatically. There is also a one-click deployment option through a hosted service called PikaPods for people who want self-hosting without managing the server infrastructure themselves. The project is open source and accepts community contributions. It uses a PostgreSQL database for storage and is built with Next.js and React on the frontend, though those technical details are mostly invisible to end users. The application is free to use, the developers accept optional financial support through Ko-fi and a Chinese crowdfunding platform, and a portion of PikaPods deployment fees goes back to the project.

Copy-paste prompts

Prompt 1
Give me the Docker command to deploy Blinko on my VPS so I can start taking private, AI-searchable notes right away.
Prompt 2
How do I set up Blinko's AI search so I can find notes by asking questions like 'what did I write about my product launch'?
Prompt 3
Show me how to write and organize notes in Blinko using Markdown so I can add headings, bold text, and checklists.
Open on GitHub → Explain another repo

← blinkospace on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.