Skip to content

ApeCodeAI/thinktape

BranchesTags

Repository files navigation

ThinkTape 🎙️

Voice & Video First 的个人思维录音带 — AI-native, Agent-ready, Open Source

License: Apache 2.0 Python Stars Sponsored by BytePass

Built by ApeCode.ai · Sponsored by BytePass.ai

ThinkTape 是一个 Voice & Video First 的开源个人思维录音带。语音和视频是第一输入方式——走路、开车、散步时随手说，本地 Whisper 自动转写。文字、图片、链接也支持。AI 自动摘要，任何 Agent 通过 CLI 直接调用。

中文 · English

中文

Why ThinkTape?

不是"另一个笔记工具"。ThinkTape 解决的问题是：

  • 🎙️ Voice & Video First — 语音和视频是第一输入方式。走路、开车、散步时随手说，本地 Whisper 自动转写。原始音视频永久保留，content.md 是转写产物，媒体文件是真相
  • 🤖 AI-native — 数据格式是 YAML + Markdown，AI 直接读；Agent 通过 CLI 直接调用
  • 🔗 [[双链]] — 支持 Obsidian 风格的 [[wikilink]]，在碎片之间建立关联
  • 🔒 Local File First — 每条记录是一个本地文件夹，你完全拥有数据，可直接嵌入 Obsidian vault
  • 🧩 Agent-ready — 不只是你往里 dump，你的 AI 助手也能帮你沉淀知识
  • ♻️ 数据永久保留，代码随时可换 — 文件即真相，SQLite 只是索引，可随时重建

vs Flomo / Apple Notes / Obsidian

ThinkTape Flomo Apple Notes Obsidian
语音/视频转写 ✅ 本地 Whisper 无限制 ⚠️ 仅 1 分钟 ❌ ❌
AI 摘要 ✅ ❌ ❌ (插件)
[[双链]] ✅ Obsidian 兼容 ❌ ❌ ✅
Agent 可调用 (CLI) ✅ ❌ ❌ ❌
Local File First ✅ YAML + Markdown 私有 DB 私有 ✅ Markdown
开源 ✅ Apache 2.0 ❌ ❌ ❌

Quick Start

1. 安装

git clone https://github.com/ApeCodeAI/thinktape.git
cd thinktape
uv sync --extra transcribe

2. 配置

mkdir -p ~/thinktape-data
cp config.example.toml ~/thinktape-data/config.toml
# 编辑 ~/thinktape-data/config.toml，填入 Telegram api_id / api_hash / bot_token

api_id / api_hash 在 https://my.telegram.org 申请；bot_token 找 @BotFather。

3. 构建前端

cd frontend && npm install && npm run build && cd ..

4. 运行

uv run thinktape serve   # bot + web + 转写一起启动
  • 🤖 给你的 Telegram Bot 发消息（文字 / 语音 / 图片 / 链接）
  • 🌐 打开 http://localhost:8080 浏览
  • 💻 命令行：uv run thinktape add "你的想法"

Docker（一行启动）

mkdir -p ~/thinktape-data
cp config.example.toml ~/thinktape-data/config.toml
# 编辑 config.toml
docker compose up -d

CLI（AI-first）

CLI 默认输出 JSON（给 Agent 解析用），加 --human 给人看。

# 记录
thinktape add "今天的想法"
thinktape add --type bookmark --bookmark-url "https://..." "my notes"
thinktape add --audio voice.opus --tag "语音"
echo "piped content" | thinktape add -
thinktape add --file notes.md --tag "笔记"

# 检索
thinktape list --today --human
thinktape search "Agent"
thinktape get <id> --content    # 纯文本，方便 pipe 给 LLM

# 管理
thinktape update <id> --tag "AI"
thinktape delete <id>
thinktape stats
thinktape tags

# AI 摘要
thinktape summarize <id>
thinktape summarize --all

完整 CLI 文档见 skill/SKILL.md。

Agent 集成

任何 AI Agent（Claude Code / Codex / 自定义 Agent）都可以通过 CLI 使用 ThinkTape：

# Agent 沉淀一次讨论的结论
thinktape add --tag "讨论" "核心观点：Agent 需要长期记忆"

# Agent 检索用户今天的想法
thinktape list --today | jq '.items[].content'

# Agent 搜索相关上下文
thinktape search "产品想法" | jq -r '.items[].content'

# Pipe 给 LLM 做主题归纳
thinktape search "AI" | jq -r '.items[].content' | llm "总结共同主题"

仓库包含 skill/SKILL.md，支持 skill discovery 的 Agent 框架可以自动发现使用方式。

数据结构

~/thinktape-data/
  config.toml                        # 配置
  items/                             # 所有原始数据（唯一重要的目录）
    20260619-143052-a3f8/            # 每条记录 = 一个目录
      item.yaml                      # 元数据（type / tags / 时间戳）
      content.md                     # 内容（Markdown）
      audio.opus                     # 语音（可选）
      images/001.jpg                 # 图片（可选）
  thinktape.db                       # SQLite 索引，可从 items/ 重建
  thinktape_bot.session              # Telegram Bot session

数据永久保留，代码随时可换。 你可以重写整个 codebase —— items/ 不会动。

uv run thinktape rebuild-index   # 从 items/ 重建 SQLite 索引

技术栈

  • Backend: Python 3.12+ / FastAPI / SQLite (索引) / Pyrofork (Telegram MTProto)
  • 转写: faster-whisper (本地，可选 GPU)
  • AI: OpenAI-compatible API (Kimi K2.5 / GPT / Claude)，可选
  • Frontend: React 19 / Vite / Tailwind CSS v4 / shadcn/ui

配置说明

全部可配置项见 config.example.toml。

Section 说明
[telegram] Bot 凭证 + 允许的用户 ID 白名单
[transcribe] Whisper 模型大小（tiny / base / small / medium / large-v3）
[web] Web 监听地址和端口
[llm] AI 摘要（OpenAI-compatible，默认关闭）

环境变量：

  • THINKTAPE_DATA_DIR — 覆盖数据目录（默认 ~/thinktape-data）
  • MOONSHOT_API_KEY / OPENAI_API_KEY — LLM provider 凭证

测试

uv run pytest tests/ -v

贡献

欢迎 issue 和 PR。请遵守 Apache 2.0。

English

ThinkTape is a Voice & Video First open-source personal think tape. Voice and video are the primary input — capture ideas while walking, driving, or cooking; local Whisper transcribes automatically. Text, images, and links are also supported. Any AI agent can read and write through a clean JSON CLI.

Part of the ApeCode.ai open source ecosystem, sponsored by BytePass.ai.

Why?

This is not yet another note-taking app. ThinkTape exists for a different reason:

  • Voice & Video First — voice and video are the primary input. Capture ideas while walking, driving, or cooking; local Whisper transcribes automatically. Original media files preserved forever.
  • AI-native — data is stored as YAML + Markdown files. AI can read it directly. Agents call the CLI directly.
  • [[Bi-directional Links]] — Obsidian-style [[wikilinks]] to connect fragments into a knowledge graph.
  • Local File First — every item is a self-contained folder on your disk. Can be embedded into an Obsidian vault.
  • Agent-ready — your AI assistants can dump into your second brain, not just you.
  • Forever data, replaceable code — files are the source of truth, SQLite is a rebuildable index.

Quick Start

# 1. Install
git clone https://github.com/ApeCodeAI/thinktape.git
cd thinktape
uv sync --extra transcribe

# 2. Configure
mkdir -p ~/thinktape-data
cp config.example.toml ~/thinktape-data/config.toml
# Edit ~/thinktape-data/config.toml with Telegram credentials
# Get api_id/api_hash at https://my.telegram.org
# Get bot_token from @BotFather

# 3. Build frontend
cd frontend && npm install && npm run build && cd ..

# 4. Run
uv run thinktape serve

Open http://localhost:8080, message your Telegram bot, or use the CLI directly.

Docker

mkdir -p ~/thinktape-data
cp config.example.toml ~/thinktape-data/config.toml
# edit config.toml
docker compose up -d

CLI (AI-first)

Default output is JSON for agents. Add --human for readable output.

thinktape add "your thought"
thinktape add --type bookmark --bookmark-url "https://..." "commentary"
thinktape add --audio voice.opus --tag voice
echo "piped" | thinktape add -

thinktape list --today --human
thinktape search "Agent"
thinktape get <id> --content     # raw text, pipe to LLM

thinktape update <id> --tag AI
thinktape stats
thinktape tags
thinktape summarize <id>

See skill/SKILL.md for the full agent-facing reference.

Data Structure

~/thinktape-data/items/
  20260619-143052-a3f8/   # one directory per item
    item.yaml             # metadata (type, tags, timestamps)
    content.md            # the actual content
    audio.opus            # voice recording (optional)
    images/001.jpg        # photos (optional)

Data is permanent. Code is temporary. You can rewrite the entire codebase and your items survive untouched. Rebuild the index any time:

uv run thinktape rebuild-index

Tech Stack

  • Backend: Python 3.12+, FastAPI, SQLite, Pyrofork (Telegram MTProto)
  • Transcription: faster-whisper (local, optional GPU)
  • AI: OpenAI-compatible APIs (optional, off by default)
  • Frontend: React 19, Vite, Tailwind v4, shadcn/ui

Configuration

See config.example.toml for all options.

Environment variables:

  • THINKTAPE_DATA_DIR — override the data directory (default ~/thinktape-data)
  • MOONSHOT_API_KEY / OPENAI_API_KEY — LLM provider credentials

Tests

uv run pytest tests/ -v

License

Apache License 2.0 — see LICENSE.

About

ThinkTape — a Voice & Video First open-source personal think tape. Voice & Video First 的个人思维录音带

ApeCode.ai

Topics

inspiration memo braindump second-brain

Resources

Readme

License

View license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 3

v2.0.0 — Voice & Video First Latest
Jun 19, 2026
+ 2 releases

Packages

 
 
 

Contributors

Languages