September

September is an assistive communication app for people with ALS, MND, or other speech and motor difficulties. It helps a user express a full thought with fewer keystrokes.

The screenshots on this page show the browser app with sample data.

Applications

September contains three applications:

• apps/web is the browser application.
• apps/desktop is the Tauri application for macOS.
• apps/keyboard is the native floating keyboard for macOS.

The web and desktop applications import the same rules, autocomplete engine, design system, and application screens from the root workspace packages. Each app keeps its own route bootstrap and platform services. The web app also has a public landing page at /.

The web app stores data and its bounded speech cache in one IndexedDB database. The desktop app stores domain data in SQLite and provider keys in the macOS Keychain.

Features

• Talk spaces combine saved phrases, word suggestions, and a text composer.
• Setup asks how the person chooses things: touch, a mouse, a keyboard, a switch, or eye gaze. Every key is 48px or more. Eye gaze presses a key after a dwell, and switch scanning steps through the groups of keys.
• A suggestion row can start with the typed words or contain them. The Mac app shows Talk in one panel that floats above other apps.
• A note is a Markdown document. The writing tools and the Talk suggestions open at the caret, and a list of notes sits beside the page.
• Each space has an Agent that can read its context and propose approved changes to its setup, notes, phrases, and Talk transcript.
• System and ElevenLabs voices speak Talk messages and notes.
• The ElevenLabs Dialogue voice reads audio tags such as [laughs]. Five mood keys set the tone of the suggestions.
• Notes store prepared long-form text inside a space.
• A note presents full-screen in the user's voice, and exports as text, audio, or a captioned video.
• Phrase codes expand short input into a full phrase.
• Local usage reports show saved keystrokes and provider use.
• AI Assistance uses one provider. Suggestions have their own model. The agent and phrases share a second model.
• Separate switches control automatic AI suggestions, phrase generation, and the agent. AI suggestions wait for a space or punctuation.
• A portable JSON backup moves settings and data between the browser and Mac apps.
• ElevenLabs can create a cloned voice from browser or desktop recordings.
• Help groups step-by-step guidance by task, searches the shared guide catalog, and labels each guide for the browser, Mac app, or Mac keyboard.

Help remains available before setup is complete. The setup screen opens its guide inline, while /help and each stable guide link open the full Help screen.

Screens

A note holds prepared long-form text inside a space. The same words read aloud, present, or export.

Present fills the screen with one chunk of the note at a time and speaks it in the user's voice.

Today reports the typing the app saved and what the services cost. The numbers stay on the device.

Requirements

• Node.js 20 or later
• pnpm
• Rust and the Tauri system requirements for desktop builds
• Swift 6 and Xcode command-line tools for the native keyboard

Install

Install the JavaScript workspace from the repository root:

pnpm install

The web app does not use environment variables for provider keys. Add OpenRouter or ElevenLabs keys in the application settings.

Develop

Check every package from the repository root:

pnpm build
pnpm lint
pnpm test

The packages share one configuration. tsconfig.base.json holds the compiler options, eslint.config.mjs holds the lint rules, vite.shared.ts holds the Vite and Vitest pieces, and vitest.setup.ts gives jsdom what React tests need.

Start the browser application:

make dev

The application opens at http://localhost:3009.

Start the desktop application:

make desktop-dev

Start the native keyboard:

make mac-run

Build its signed app bundle or installable DMG:

make mac-app
make keyboard-dmg

The keyboard uses the bundle identifier com.september.keyboard. The DMG is written to apps/keyboard/.build/release/Keyboard.dmg.

Release the desktop app

Store the Apple signing values in the ignored root .envrc file:

export APPLE_TEAM_ID=...
export APPLE_SIGNING_IDENTITY=...
export APPLE_PROVISIONING_PROFILE=...
export APPLE_API_ISSUER=...
export APPLE_API_KEY=...
export APPLE_API_KEY_PATH=...

Create the signed desktop installer from the repository root:

make desktop-release

The command builds the app and DMG, submits both to Apple, staples the tickets, checks the DMG with Gatekeeper, and prints its path and SHA-256 checksum.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗