Powered by Gemma · free to run

A tiny AI creature that lives on your desktop.

Gemlin walks along the bottom of your screen, keeps an eye on your Downloads, and teaches itself new tricks. You approve every one.

What it does

senses

Knows your laptop

Checks your Downloads, finds the biggest files, spots busy processes, and reads disk space and battery. It sees names, sizes and dates, never what's inside your files.

desktop pet

Lives on your screen

Walks back and forth, turns to face you when it talks, and answers in speech bubbles. Click it to chat, or drag it somewhere else.

learn_skill

Teaches itself tricks

Ask for something it can't do yet and it writes a new Python tool. It shows you the code first, and nothing runs until you type y.

safe by default

You're in charge

Its tools only look; they never change anything. Its one action moves a file into a review folder, never deletes, and always asks first.

Ask it anything about your laptop

Chat in the terminal or click Gemlin on your desktop. Every time it uses a tool you'll see it, and anything that changes your machine waits for your y.

Want a new personality? A dragon that hoards big files, an anxious librarian? Make your own.

how bad is my Downloads folder?

🔧 calling scan_downloads

142 files, 9.8 GB. Three copies of the same installer? Bold.

learn a skill that counts my Downloads by file type

🔧 calling learn_skill

Install this skill? Only say y if you read and understand the code. [y/N]

Installed count_by_extension. Ask me again!

Get started

You need Python 3.10 or newer and a Google account. It takes about five minutes.

  1. Get a free API key

    At aistudio.google.com/apikey. Keep it to yourself; never paste it into code.

  2. Download Gemlin

    git clone https://github.com/alexinslc/gemlin cd gemlin

    No git? Use Download ZIP, unzip it, and open a terminal in the folder.

  3. Install it

    python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt
  4. Add your key

    export GEMINI_API_KEY="your-key-here"
  5. Wake it up

    python3 gemlin.py

    Gemlin appears in your terminal and on your desktop. Make your own Gemlin first if you like: the creator gives you one command that does it all.

The workshop

Build your own at Hacktoberfest Hack Day

Draper × AMH · October 16, 2026

The theme is AI belongs to everyone. You'll get Gemlin running, give it a personality, and teach it a new skill of your own. No AI experience needed.

  • Bring a laptop with Python 3.10 or newer.
  • Have a Google account ready for your free API key.
  • Curious what to build? Wifi info, screen time, git repos with uncommitted changes…