Skip to content

dale0525/SecondLoop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,046 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SecondLoop

SecondLoop

Close your open loops.

Local‑first personal AI assistant with long‑term memory and an encrypted vault — built for mobile + desktop.

https://secondloop.app

English · 简体中文

Contributing

Official launch SecondLoop Community Edition is now officially launched for macOS, Windows, Android, and Linux (x64). We no longer plan destructive data format changes in normal releases.

✨ What is SecondLoop?

SecondLoop is an open-source (Community Edition), privacy‑first “second brain” that helps you capture, remember, and act — without turning your life into folders and tabs.

The core mental model is One Timeline (a single “Main Stream”): capture first, then ask when needed.

⭐ Highlights

  • 🧠 Long-term memory, local-first: your timeline stays on your device with encryption by default.
  • 🧲 Ask AI with relevant context: get answers grounded in your own notes, with streaming output.
  • 🗂️ Simple filters when needed: narrow what you are viewing without juggling chat threads.
  • 📥 Capture from anywhere: mobile share sheet + desktop global hotkey for quick capture.
  • 🔐 Privacy by design: encrypted vault and clear control over where your data lives.
  • 🌍 Cross-platform: one app experience across mobile and desktop.

🤖 AI Capability Matrix (Local / BYOK / Pro)

AI capability Local (on-device) BYOK (your API key) Pro subscription (SecondLoop Cloud) Notes
Image annotation ⚠️ Basic on-device description ✅ Use your own model API ✅ Included via SecondLoop Cloud If network AI is unavailable, the app can still provide a lightweight fallback from visible text.
OCR (image/PDF/doc) ✅ On-device text recognition ✅ Use your own model API ✅ Included via SecondLoop Cloud Works for images and supported documents.
Speech recognition (audio transcription) ⚠️ Available on supported devices ✅ Use your own model API ✅ Included via SecondLoop Cloud When offline, the app uses local transcription when available.
Embedding indexing ✅ Local memory indexing ✅ Use your own embedding API ✅ Included via SecondLoop Cloud New content is indexed in the background.
Ask AI ✅ Use your own chat model API ✅ Included via SecondLoop Cloud Route follows your source preference and current availability.
Semantic parsing (intent/time-window understanding) ✅ Use your own model API ✅ Included via SecondLoop Cloud Used by smart understanding and auto-actions.
Embedding search ✅ Local semantic search ✅ Use your own embedding API ✅ Included via SecondLoop Cloud Search can fall back across available routes.
  • Local means native on-device processing in iOS / Android / macOS / Windows / Linux clients.
  • BYOK means you connect your own model service and API key in settings.
  • Pro means an active SecondLoop Pro entitlement with a signed-in cloud account.
  • Capabilities will continue to evolve, while public release compatibility remains a priority.

🚀 Usage

Availability

  • Download from GitHub Releases (macOS/Windows/Android/Linux assets).
  • iOS is not live yet.
  • If you want to run from source, see CONTRIBUTING.md.

Package manager install (optional)

  • macOS (Homebrew):
    • brew tap dale0525/SecondLoopHomebrew
    • brew install --cask secondloop
  • Windows (WinGet):
    • winget install --id SecondLoop.SecondLoop --exact
  • Package indexes may lag behind GitHub Releases for a short period after each tag.

Linux notes (current limitations)

  • Linux currently ships as a portable .tar.gz package (no Snap/Flatpak/APT package yet).
  • Markdown → PDF export is not available on Linux yet.
  • Desktop biometric unlock integration is not available on Linux yet; use your app password to unlock.

Quick walkthrough

  1. Create your vault (first run) Local data is encrypted at rest. You’ll enter your master password when the vault is first locked/unlocked.

  2. Capture (Send) Use the chat input to quickly save thoughts/links, or:

    • Mobile: share text/URL/images from other apps into SecondLoop
    • Desktop: press ⌘⇧K (macOS) / Ctrl+Shift+K (Windows/Linux) for quick capture
  3. Ask AI (explicit) Use Ask AI when you want an answer; SecondLoop uses your relevant memories as context and sends only what is needed to the model.

Privacy note (what gets uploaded)

When Ask AI uses a remote model (BYOK or SecondLoop Cloud), the client uploads your question + only the relevant context needed for that answer. It does not upload your keys, master password, or your entire vault/history.

🔄 Desktop update strategy (current)

  • Windows: MSI-only release path; updates are manual via MSI download, release page, or WinGet.
  • Windows artifact contract: the official release asset is SecondLoop-win.msi, with checksum file SecondLoop-win.msi.sha256.
  • macOS: manual DMG download/update (no paid signing/notarization yet).
  • If release-note generation fails in GitHub Actions, rerun the workflow manually; there is no automatic fallback notes path.
  • Windows release automation uses .github/workflows/release.yml and scripts/publish_winget_manifest.sh.

🧩 Editions (Community vs Cloud)

  • Community Edition (this repo): BYOK (bring your own key), local‑first, encrypted vault, and BYOS (bring your own storage) sync backends.
  • SecondLoop Cloud (premium, managed): optional hosted services (account, AI gateway, managed vault, realtime sync).

📄 License

  • The SecondLoop Community Edition (this repository) is licensed under the Apache License 2.0. See LICENSE.
  • SecondLoop Cloud (managed hosted services and billing infrastructure) is not distributed in this repository and is offered under separate commercial terms.

🤝 Contributing

If you want to contribute, please read CONTRIBUTING.md for development setup, commands, platform prerequisites, and release process details.

About

Local-first personal AI assistant.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors