# nomily-app (nomily-ai/nomily-app)

> Nomily AI is a BYOK (bring-your-own-key) voice recording companion for the V05E BLE recorder, iPhone, and Apple Watch, offering ASR transcription, speaker diarization, and AI-generated summaries where you choose and pay for your own transcription and LLM providers.

- GitHub: https://github.com/nomily-ai/nomily-app
- GitHub.Locker page: https://github.locker/nomily-ai/nomily-app
- Stars: 1K
- Last push: 2026-11-16

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is this repository something I can install, or just an entry point?**

This repo is the project entry point with docs, license, and preview assets only — the actual installable clients live in separate repos, nomily-ios (SwiftUI) and nomily-android (Kotlin/Jetpack Compose).

**How do I get it running?**

Build nomily-ios in Xcode 15+ for iPhone/Apple Watch, or build nomily-android with JDK 21 and Android Studio/Gradle for Android; each client repo has its own build instructions.

**Do I need my own Azure or OpenAI API keys?**

Yes — transcription runs through Azure Speech or a self-operated faster-whisper-compatible endpoint, and summaries need a configured LLM provider such as OpenAI, Anthropic, Gemini, OpenRouter, or Ollama that you supply and pay for yourself.

**Does it work with any Bluetooth recorder, or just V05E?**

Only the V05E BLE recorder workflow is implemented and tested; other recorder models aren't committed as supported, and there's no published Android Wear OS companion yet.

**Where do my recordings and transcripts go?**

Everything flows only to providers you configure yourself — audio goes to Azure or your own local ASR endpoint, and transcript text goes only to your chosen LLM provider; there is no shared Nomily cloud or bundled provider account.

**How many speakers can diarization handle?**

Azure-based transcription supports speaker diarization for up to 10 speakers in a single recording.

**Can I try it without a device or API key?**

Yes, a fixed-data online demo is available on the Nomily site; it previews the workflow with sample data and never uploads audio or calls any ASR/LLM service.

**Is there an Apple Watch app?**

Yes — after installing Nomily AI on iPhone you install its Watch companion from the Watch app's Available Apps list, letting you record on the Watch alone and sync it back to the iPhone client.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/nomily-ai/nomily-app/blob/main/README.md

# Nomily AI

> **Recorder → Nomily AI → Your API Key → Your AI**

<p align="center">
  <img src="media/nomily-workflow-banner.png" width="100%" alt="Nomily AI BYOK voice recording workflow from recorder to transcript, summary, and AI provider">
</p>

<p align="center">
  <a href="https://github.com/Nomily-Ai/nomily-ios"><img src="https://img.shields.io/badge/iOS%20%2B%20Apple%20Watch-SwiftUI-111318?style=for-the-badge&logo=swift&logoColor=white" alt="iOS and Apple Watch client"></a>
  <a href="https://github.com/Nomily-Ai/nomily-android"><img src="https://img.shields.io/badge/Android-Jetpack%20Compose-3DDC84?style=for-the-badge&logo=android&logoColor=white" alt="Android client"></a>
  <a href="https://geekis.com"><img src="https://img.shields.io/badge/BYOK-Your%20Key%20Your%20AI-E4002B?style=for-the-badge" alt="Bring your own key"></a>
  <a href="https://apps.apple.com/us/app/nomily-ai/id6811033606"><img src="https://img.shields.io/badge/iPhone-US%20App%20Store-111318?style=for-the-badge&logo=apple&logoColor=white" alt="Nomily AI on the US App Store"></a>
  <a href="https://www.amazon.com/dp/B0HHGWYS6J?maas=maas_adg_7561A19815A1FBF370F5F7E1AAD78D3E_afap_abs&ref_=aa_maas&tag=maas"><img src="https://img.shields.io/badge/Vobot%20V05E-Buy%20on%20Amazon-FF9900?style=for-the-badge&logo=amazon&logoColor=white" alt="Buy Vobot V05E on Amazon"></a>
  <a href="https://discord.gg/uQFj3Rfv54"><img src="https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join the Nomily AI Discord community"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-Source--available-4B5563?style=for-the-badge" alt="Source-available licence"></a>
</p>

<p align="center">
  <a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.zh-TW.md">繁體中文</a>
</p>

**BYOK voice-recording companion for Vobot V05E, Apple Watch, and audio imported on iPhone —
ASR transcription, speaker diarization, AI summaries, and local ASR endpoint
support.**

Nomily AI brings recordings into a native client, transcribes them with a provider
you configure, and generates a summary with an AI provider you choose.

This repository is the project entry point. The runnable native clients live in
[`nomily-ios`](https://github.com/Nomily-Ai/nomily-ios) and
[`nomily-android`](https://github.com/Nomily-Ai/nomily-android).

## Quick links

| 📱 iPhone app | 🤖 Android app | 🌐 Online demo | 🎥 Video demos | 𝕏 Updates | 💬 Discord | 📚 Documentation |
|---|---|---|---|---|---|---|
| [Download on the US App Store](https://apps.apple.com/us/app/nomily-ai/id6811033606) | [Get it on Google Play](https://play.google.com/store/apps/details?id=com.nomily.app) | [Try the fixed-data preview](https://geekis.com/demo/) | [Nomily AI on YouTube Shorts](https://www.youtube.com/@Nomily-Ai/shorts) | [@nomilyai](https://x.com/nomilyai) | [Join the community](https://discord.gg/uQFj3Rfv54) | [Geekis.com](https://geekis.com) |

> **Have a Vobot V05E in mind?** [**Buy Vobot V05E on Amazon →**](https://www.amazon.com/dp/B0HHGWYS6J?maas=maas_adg_7561A19815A1FBF370F5F7E1AAD78D3E_afap_abs&ref_=aa_maas&tag=maas)
> The V05E is Nomily AI's primary BLE recording input.

## Choose your path

| Build or need | Start here |
| --- | --- |
| Build for iPhone or Apple Watch | [nomily-ios](https://github.com/Nomily-Ai/nomily-ios) |
| Install Nomily AI on iPhone | [Download on the US App Store](https://apps.apple.com/us/app/nomily-ai/id6811033606) |
| Install Nomily AI on Android | [Get Nomily AI on Google Play](https://play.google.com/store/apps/details?id=com.nomily.app). |
| Build for Android | [nomily-android](https://github.com/Nomily-Ai/nomily-android) |
| Explore the workflow without a device, key, or upload | [Try the fixed-data demo](https://geekis.com/demo/) |
| Get help, report a documentation issue, or ask about licensing | [SUPPORT.md](SUPPORT.md) · [nomily@geekis.com](mailto:nomily@geekis.com) |

This repository is not an installable client or a Docker deployment. Read the
client-specific build instructions before starting a local build.

## Project navigation

- [Architecture and integration boundary](ARCHITECTURE.md): exact client,
  device, provider, and local-ASR boundaries.
- [Public roadmap](ROADMAP.md): what is available, in progress, or only under
  evaluation.
- [Agent guide](AGENTS.md) · [LLM navigation](llms.txt): concise project map
  for code agents and other machine readers.

## What is Nomily AI?

Nomily AI is not a hosted transcription account or a shared recording cloud. It is
a native companion workflow for recordings and user-configured AI services. The
app keeps the choice of transcription and summary provider with the user.

The public repositories provide source for inspection and local builds. Store
availability may vary by storefront and version; source commits do not promise
device/firmware compatibility or a production service release.

## What it does today

- Connects to the V05E BLE recorder workflow, downloads recordings, and manages
  a local recordings library.
- Imports recordings on iPhone, including recordings transferred from the Apple
  Watch companion.
- Transcribes live or recorded audio through Azure Speech or a user-operated
  local faster-whisper-compatible ASR endpoint; Azure transcription enables
  speaker diarization for up to 10 speakers.
- Generates summaries, titles, and translations with a configured LLM provider:
  OpenAI, Anthropic, Gemini, OpenRouter, Ollama, or a custom OpenAI-compatible
  endpoint.
- Provides native iOS / Apple Watch and Android implementations rather than a
  cross-platform wrapper.

## Privacy and provider boundaries

Nomily AI is not a hosted transcription account or a shared recording cloud. API
keys are supplied by the user and must never be committed. Keep recordings,
transcripts, device identifiers, logs, generated configuration files, and access
credentials out of issues and pull requests.

Nomily AI does not charge a subscription fee. Third-party ASR and LLM costs are
paid separately under the selected provider's pricing.

| Service layer | Data sent in a configured workflow | Who provides it |
|---|---|---|
| Nomily AI client | Recording library, transfer state, and generated files on the client | You install and operate the client. |
| Azure Speech | Audio for transcription, when Azure is selected | Your Azure account and key. |
| Local ASR endpoint | Audio for transcription, when a local endpoint is selected | You operate the endpoint. |
| LLM provider | Transcript text needed for summary, title, or translation | Your selected provider, model, endpoint, and key. |
| Your storage (optional) | Recordings, transcripts, and exports that you choose to save or sync | Your iCloud Drive, NAS, Nextcloud, or other storage setup. |

The public repositories do not include a shared Nomily AI cloud, a bundled provider
account, or a complete self-hosted sync stack. Local ASR and Ollama are
provider integrations, not a claim that every product layer is self-hosted.

## How it works

```text
Vobot V05E recorder / Apple Watch / audio imported on iPhone
                  │
                  ▼
        Nomily AI native client
  local library · transfer · playback
                  │
        ┌─────────┴──────────┐
        ▼                    ▼
Azure Speech or        Your LLM provider
local ASR endpoint     summary · title · translation
diarization when       OpenAI · Anthropic · Gemini
Azure is selected      OpenRouter · Ollama · compatible endpoint
        │                    │
        └─────────┬──────────┘
                  ▼
         Transcript and summary
                  │ optional save / sync
                  ▼
 iCloud Drive / NAS / Nextcloud / your storage
```

<p align="center">
  <img src="media/diagrams/nomily-byok-data-flow.svg" width="900" alt="Nomily AI BYOK data flow showing user-configured ASR, AI providers, and optional iCloud Drive, NAS, or Nextcloud storage">
</p>

Optional storage remains under your control: save or sync recordings, transcripts,
and exports with your own iCloud Drive, NAS, Nextcloud, or other storage setup.

## Advanced: run ASR and an LLM on your own network

This is an optional advanced setup, not a complete self-hosted Nomily stack.
Run both services on a trusted computer on the same private Wi-Fi as the phone;
do not expose either service to the public internet.

### 1. Local Whisper transcription

The included reference service implements the exact Local ASR Server contract:
WebSocket port `12300` for live audio and HTTP port `12301` for recording files.
It needs Python 3.10+ and `ffmpeg` (`brew install ffmpeg` on macOS, or
`sudo apt install ffmpeg python3-venv` on Ubuntu/Debian).

```bash
git clone https://github.com/nomily-ai/nomily-app.git
cd nomily-app/examples/local-asr-server
python3 -m venv .venv && source .venv/bin/activate
pip install -r nomily_local_asr/requirements.txt
python -m nomily_local_asr --host 0.0.0.0 --port 12300 --http-port 12301 --model small --lang auto
```

The first run downloads the Whisper model. Follow the complete
[local ASR reference guide](examples/local-asr-server/README.md), including a
local `curl` test and firewall notes. For a guided local installation, copy
the [English AI-agent deployment prompt](examples/local-asr-server/AI_AGENT_SETUP_PROMPT.md)
into an agent running on the computer that will host the services.

### 2. Local Ollama summaries

Install Ollama from [ollama.com/download](https://ollama.com/download/), then
download a model:

```bash
ollama pull qwen3:8b
# Linux foreground service; bind to LAN only when the phone must reach it.
OLLAMA_HOST=0.0.0.0:11434 ollama serve
```

If Ollama is managed by its desktop app or a service manager, set its
`OLLAMA_HOST` environment variable to `0.0.0.0:11434` and restart that service.
This makes it reachable on the LAN; it does not add authentication.

### 3. Find the computer address and fill in Nomily AI

Keep the phone and computer on the same Wi-Fi, then run one of these commands:

```bash
# macOS
ipconfig getifaddr en0
# Linux
hostname -I
```

If the computer prints `192.168.1.20`, enter the following in the phone app:

| Nomily AI screen | Field | Value to enter |
| --- | --- | --- |
| **Settings -> ASR providers -> Local ASR Server** | Host | `192.168.1.20` |
| | Port | `12300` |
| **Settings -> LLM providers -> Ollama** | Endpoint URL | `http://192.168.1.20:11434` |
| | Model | `qwen3:8b` (or a model returned by Verify) |

Do not use `localhost` or `127.0.0.1` in the phone app: those addresses point
to the phone, not to the computer. The ASR client automatically sends complete
files to port `12301`. Allow inbound LAN connections to ports `12300`, `12301`,
and `11434` only when the corresponding service is running.

## Recording input support

| Input | Current source status | Notes |
|---|---|---|
| Vobot V05E recorder | Implemented in both clients | Primary BLE recording input; compatibility still depends on the actual device and firmware under test. [View on Amazon](https://www.amazon.com/dp/B0HHGWYS6J?maas=maas_adg_7561A19815A1FBF370F5F7E1AAD78D3E_afap_abs&ref_=aa_maas&tag=maas) |
| Apple Watch microphone | Implemented in `nomily-ios` | The watchOS companion records on Watch and transfers recordings to the paired iPhone client. |
| Audio files already on iPhone | Implemented in `nomily-ios` | Import files into the library for transcription and summary workflows. This is a file-import feature, not a device-integration claim. |
| Other recorder models | No public compatibility claim | Recording or Bluetooth capability alone does not indicate Nomily support. |
| Android Watch companion | Not published | Do not infer a Wear OS client from the Android app source. |

<p align="center">
  <img src="media/diagrams/recording-input-support.svg" width="900" alt="Nomily AI recording input support and future-device boundary">
</p>

See the expandable [device compatibility matrix](media/devices/README.md)
before assuming a recorder model is supported.

## Nomily AI App

| Library | Summary | Mind Map | ASR configuration | LLM configuration | Settings |
|---|---|---|---|---|---|
| <img src="media/nomily-ai-home.png" alt="Nomily AI App recording library" width="120"> | <img src="media/nomily-ai-summary.png" alt="Nomily AI App recording summary" width="120"> | <img src="media/nomily-ai-mind-map.png" alt="Nomily AI App mind map built from a meeting" width="120"> | <img src="media/nomily-ai-asr.png" alt="Nomily AI App ASR provider configuration using a LAN IP placeholder" width="120"> | <img src="media/nomily-ai-llm.png" alt="Nomily AI App LLM provider configuration with a masked API key" width="120"> | <img src="media/nomily-ai-settings.png" alt="Nomily AI App settings" width="120"> |

These current App previews make the full workflow visible: library, summary,
Mind Map, ASR, LLM, and settings. Platform-specific build instructions remain
in the respective native-client repositories. Key fields are masked and the
screens use non-sensitive test content. Review [`media/README.md`](media/README.md)
before reusing product imagery or brand assets.

## Apple Watch companion

### Watch preview

| Watch library | Recap | Recording |
|---|---|---|
| <img src="media/nomily-watch-home.png" alt="Nomily Apple Watch recording library" width="220"> | <img src="media/nomily-watch-recap.png" alt="Nomily Apple Watch recap with key points" width="220"> | <img src="media/nomily-watch-recording.png" alt="Nomily Apple Watch recording in progress" width="220"> |

These Apple Watch previews use English, non-sensitive demo content.

After Nomily AI is installed on the paired iPhone, install its Watch companion:

1. Open the **Watch** app on iPhone and scroll to **Available Apps**.
2. Find **Nomily AI** and tap **Install**.
3. In Nomily AI on iPhone, open **Settings → Apple Watch** and confirm it shows
   **Installed**.
4. Open Nomily AI on Apple Watch and record when V05E is not with you. The
   recording syncs to the iPhone Nomily AI app for transcription, organization,
   and summaries.

| Install from Watch App | Confirm in Nomily AI settings | Record on Apple Watch |
|---|---|---|
| <img src="media/apple-watch-install-nomily-ai.png" alt="iPhone Watch app showing Nomily AI with an Install button" width="250"> | <img src="media/apple-watch-settings.png" alt="Nomily AI settings showing Apple Watch installed" width="250"> | <img src="media/apple-watch-recording.png" alt="Nomily AI ready to record on Apple Watch" width="250"> |

### Planned or not published

| Item | Status |
|---|---|
| Other recorder models and protocols | Compatibility is not committed until tested with the relevant firmware. |
| Android Watch companion | Not published. |
| RAG, MCP, shared self-hosted sync | Not represented by the current public client source; not an announced capability. |
| Online no-key demo | A fixed-data preview is live at [Geekis.com/demo](https://geekis.com/demo/). It does not upload audio, call ASR or LLM services, or store keys. |

## Repository map

| Repository | Role | Relationship |
|---|---|---|
| **nomily-app** | Project entry, cross-project documentation, licence, and preview assets | Start here. It does not contain an installable client by itself. |
| [`nomily-ios`](https://github.com/Nomily-Ai/nomily-ios) | SwiftUI client for iPhone and Apple Watch | Its own native project, build instructions, and issue tracker. |
| [`nomily-android`](https://github.com/Nomily-Ai/nomily-android) | Kotlin / Jetpack Compose client for Android | Its own native project, build instructions, and issue tracker. |
| `nomily-site` | Private static-site deployment source | Hosts setup and demo material; it is not a mobile-client source repository. |

## Build and project layout

The clients share product concepts and protocol expectations, but are separate
native implementations. Review the relevant repository before choosing a build
path:

```text
nomily-app/       project map, licence, public preview assets
nomily-ios/       iOS app, Watch companion, BLE / ASR / local library modules
nomily-android/   Android app and core protocol, crypto, audio, ASR, LLM modules
nomily-site/      private static deployment source for guides and the demo
```

| Goal | Start here |
|---|---|
| Build for iPhone or Apple Watch | [`nomily-ios`](https://github.com/Nomily-Ai/nomily-ios) — macOS, Xcode 15+, and a physical iPhone; Apple Watch optional. |
| Build for Android | [`nomily-android`](https://github.com/Nomily-Ai/nomily-android) — JDK 21, Android Studio or Gradle, and a physical Android phone. |
| Report a defect | Open an issue in the affected native-client repository with redacted reproduction steps. |
| Need support or have a project-entry question | Read [SUPPORT.md](SUPPORT.md) or email [nomily@geekis.com](mailto:nomily@geekis.com). |
| Review terms | Read the [Nomily Small Team License](LICENSE). |

## Licence

The source is available under the [Nomily Small Team License 1.0.0](LICENSE).
It permits personal use and company use by teams of up to 10 people; larger
teams need a separate paid licence. Contact <nomily@geekis.com> for commercial
licensing. This is a source-available licence, not an OSI-approved open-source
licence.

Brand assets under [`media/`](media/) are excluded from that licence; see
[`media/README.md`](media/README.md).

## Community and security

### Join the Nomily AI Discord

Ask setup questions, share feedback, and meet other Nomily users in the
[Nomily AI Discord community](https://discord.gg/uQFj3Rfv54).

Read [CONTRIBUTING.md](CONTRIBUTING.md) before proposing a change. For general
help, use [SUPPORT.md](SUPPORT.md). Report vulnerabilities privately according
to [SECURITY.md](SECURITY.md), never in a public issue.

## Star history

[![Star History Chart](https://api.star-history.com/svg?repos=nomily-ai/nomily-app&type=date&legend=top-left)](https://www.star-history.com/#nomily-ai/nomily-app&type=date&legend=top-left)

