TEF Notes

Notes and tasks with a web app that works offline and an optional AI assistant.

  • ghcr.io/hsinghhira/tef-notes:latest
  • v0.8.0
  • Updated 10 Nov 2026
  • port 6718
  • amd64 · arm64
  • Productivity
  • 2 stars

Screenshots

TEF Notes screenshot 1: HomeTEF Notes screenshot 2: Overview

Open the app

Web App

http://localhost:6718/

PocketBase admin

http://localhost:6718/_/

About TEF Notes

TEF Notes is a self-hosted home for notes and tasks: a web app you can install on your phone that works offline, a Chrome clipper, a CLI and an optional AI assistant that reads, writes and searches your notes. PocketBase, the assistant and voice input run inside this one container.

Features

  • Notes with tags, images and attachments; tasks with Today, Upcoming and a calendar
  • Works offline and installs as an app on Android (needs https)
  • Optional AI assistant with the provider you choose (DeepSeek, Anthropic, OpenAI, Ollama and more) and search by meaning
  • Voice input with speech-to-text on your server
  • Task reminders as push notifications, a CLI and an MCP server

How to use

  1. Open TEF Notes from your dashboard.
  2. Write notes and add tasks; they sync to every device.
  3. For the assistant, set your provider's key in the app settings.

Before you install

TEF Notes has no sign-in. Anyone who can reach the port can read and change your notes, so keep it on your home network or behind a VPN like Tailscale, and never open it to the internet. The PocketBase admin UI at /_/ has its own login: on the first start PocketBase prints a one-time link in the logs to create it.

For the AI assistant set TEF_NOTES_PROVIDER and your key in TEF_NOTES_LLM_KEY; leave the key empty to use it without AI. Over plain http the web app works, but the microphone and "Install app" need https. Voice input downloads a speech model (~460 MB) the first time you use it. More settings are in the Variables tab.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. Notes are dated and task reminders ring by this zone's day and time.
PUBLIC_URLhttp://localhost:6718The address you open TEF Notes at, like http://192.168.1.20:6718 or your https address. It is only shown in the logs; the app works from any address.
TEF_NOTES_PROVIDERdeepseekThe AI model provider for the assistant and clip write-ups: deepseek, anthropic, openai, xai, qwen, zai or ollama.
TEF_NOTES_LLM_KEY—Your API key for that provider. Leave it empty to use TEF Notes without the AI assistant (Ollama needs none).

AI assistant

VariableDefault valueDescription
TEF_NOTES_MODEL—The model to use. Left out, the provider's default; Ollama needs a model you have pulled.
TEF_NOTES_LLM_URL—The provider's API address, if not its own (for example another region).
TEF_NOTES_OLLAMA_URL—Your Ollama server with TEF_NOTES_PROVIDER=ollama, like http://192.168.1.20:11434.
TEF_NOTES_TYPESAFE_KEY—A JEV (typesafe) key for automatic tags and clip suggestions.
TEF_NOTES_EXA_KEY—An Exa key, so the assistant can search the web.
TEF_NOTES_MCP0Set to 1 to serve the note and task tools to other agents (Claude Code, Cursor...) at /agent/mcp.

Voice input

VariableDefault valueDescription
TEF_NOTES_STThttp://127.0.0.1:8099Set it empty to turn voice input off (nothing is downloaded then).

Reminders

VariableDefault valueDescription
TEF_NOTES_VAPID_SUBJECT—A mailto: or https address the push services may reach you at. Task reminders on phones are off until it is set.
TEF_NOTES_PUSH_KEY—Your own VAPID private key. Left out, one is made on first start.
docker-compose.yml
name: tef-notes

services:
  tef-notes:
    image: ghcr.io/hsinghhira/tef-notes:latest
    container_name: tef-notes
    restart: unless-stopped
    stop_grace_period: 60s
    privileged: true
    environment:
      - TZ=$TZ
      - PUBLIC_URL=http://localhost:6718
      - TEF_NOTES_PROVIDER=deepseek
      - TEF_NOTES_LLM_KEY=
    ports:
      - target: 8080
        published: "6718"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:8080/api/health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 90s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 2048M
        reservations:
          cpus: "0.10"
          memory: 192M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tef-notes/icon.png
    x-casaos:
      id: com.icestore.tef-notes
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. Notes are dated and task reminders ring by this
              zone's day and time.
        - container: PUBLIC_URL
          description:
            en_US: >-
              The address you open TEF Notes at, like http://192.168.1.20:6718
              or your https address. It is only shown in the logs; the app
              works from any address.
        - container: TEF_NOTES_PROVIDER
          description:
            en_US: >-
              The AI model provider for the assistant and clip write-ups:
              deepseek, anthropic, openai, xai, qwen, zai or ollama.
        - container: TEF_NOTES_LLM_KEY
          description:
            en_US: >-
              Your API key for that provider. Leave it empty to use TEF Notes
              without the AI assistant (Ollama needs none).
      ports:
        - container: "8080"
          description:
            en_US: TEF Notes web app, API (/api), agent (/agent) and PocketBase admin (/_/), published on host as 6718
      volumes:
        - container: /data
          description:
            en_US: >-
              The notes database (pb_data/), the agent's search index
              (agent/), the speech model (stt/), the key files (keys/) and the
              push key (state/). Back up the whole folder.

x-casaos:
  id: com.icestore.tef-notes
  architectures:
    - amd64
    - arm64
  main: tef-notes
  author: HSinghHira
  category: Productivity
  developer: spyrosbazios
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tef-notes/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tef-notes/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tef-notes/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/tef-notes/screenshot-2.jpg
  title:
    en_US: TEF Notes
  tagline:
    en_US: Notes and tasks with a web app that works offline and an optional AI assistant.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/tef-notes/](https://icestore.hsinghhira.me/app/tef-notes/) for full details


      TEF Notes is a self-hosted home for notes and tasks: a web app you can
      install on your phone that works offline, a Chrome clipper, a CLI and
      an optional AI assistant that reads, writes and searches your notes.
      PocketBase, the assistant and voice input run inside this one
      container.


      **Features**


      - Notes with tags, images and attachments; tasks with Today, Upcoming
        and a calendar

      - Works offline and installs as an app on Android (needs https)

      - Optional AI assistant with the provider you choose (DeepSeek,
        Anthropic, OpenAI, Ollama and more) and search by meaning

      - Voice input with speech-to-text on your server

      - Task reminders as push notifications, a CLI and an MCP server


      **How to use?**


      1. Open TEF Notes from the Zima OS dashboard.


      2. Write notes and add tasks; they sync to every device.


      3. For the assistant, set your provider's key in the app settings.
  tips:
    before_install:
      en_US: >-
        1. TEF Notes has no sign-in. Anyone who can reach it can read your
           notes, so keep it on your home network or behind a VPN, and never
           open the port to the internet.


        2. For the AI assistant, set TEF_NOTES_PROVIDER and your key in
           TEF_NOTES_LLM_KEY. Leave the key empty to use it without AI.


        3. Start the installation. It is ready in about a minute.


        4. Open TEF Notes from your dashboard. The microphone and "Install
           app" only work over https, for example through a VPN like
           Tailscale.


        5. More settings (the model, Ollama, web search, reminders) are
           listed on the TEF Notes page at
           https://icestore.hsinghhira.me/app/tef-notes/ (Variables tab).
  index: /
  port_map: "6718"
  scheme: http
  is_uncontrolled: false
  version: "0.8.0"
  update_at: "2026-11-10"
  release_notes:
    en_US: |-
      - First IceStore release: upstream's three services in one container on port 6718, with / to PocketBase and /agent to the agent as upstream's one-origin proxy rule asks.
      - AI keys are set as app settings and written to the key files upstream reads; a push (VAPID) key is made on first start.
      - tef-notes 0.8.0
      - tef-notes-agent 0.8.0
      - tef-notes-stt 0.8.0
  repo: "https://github.com/spyrosbazios/tef-notes"
  support: "https://github.com/spyrosbazios/tef-notes/issues"
  docs: "https://github.com/spyrosbazios/tef-notes/blob/main/server/README.md"

Install TEF Notes

Something not working with TEF Notes?

Report it so it gets fixed, or ask for an app that is not here yet.

More Productivity apps

See all