initial

Author: twitchard

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+      
+      - name: Install dependencies
+        run: bun install
+      
+      - name: Run tests
+        run: bun test
+      
+      - name: Check types
+        run: bun typecheck
+      
+      - name: Check formatting
+        run: bun format:check

.github/workflows/main.yml

@@ -0,0 +1,26 @@
+name: Test Bun PowerShell DateTime
+
+on:
+  workflow_dispatch:
+
+jobs:
+  test-bun-powershell:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Bun
+        shell: pwsh
+        run: |
+          iwr https://bun.sh/install.ps1 -Useb | iex
+
+      - name: Add Bun to PATH
+        shell: pwsh
+        run: |
+          echo "$HOME\.bun\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
+
+      - name: Test Process StartTime
+        shell: pwsh
+        run: |
+          bun install && bun run src/config.ts

.gitignore

@@ -0,0 +1,181 @@
+tts-audio
+# Based on https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore
+
+# Logs
+
+logs
+_.log
+npm-debug.log_
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Caches
+
+.cache
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# Runtime data
+
+pids
+_.pid
+_.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+
+lib-cov
+
+# Coverage directory used by tools like istanbul
+
+coverage
+*.lcov
+
+# nyc test coverage
+
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+
+bower_components
+
+# node-waf configuration
+
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+
+build/Release
+
+# Dependency directories
+
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+
+web_modules/
+
+# TypeScript cache
+
+*.tsbuildinfo
+
+# Optional npm cache directory
+
+.npm
+
+# Optional eslint cache
+
+.eslintcache
+
+# Optional stylelint cache
+
+.stylelintcache
+
+# Microbundle cache
+
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+
+.node_repl_history
+
+# Output of 'npm pack'
+
+*.tgz
+
+# Yarn Integrity file
+
+.yarn-integrity
+
+# dotenv environment variable files
+
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+
+.parcel-cache
+
+# Next.js build output
+
+.next
+out
+
+# Nuxt.js build / generate output
+
+.nuxt
+dist
+
+# Gatsby files
+
+# Comment in the public line in if your project uses Gatsby and not Next.js
+
+# https://nextjs.org/blog/next-9-1#public-directory-support
+
+# public
+
+# vuepress build output
+
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+
+.temp
+
+# Docusaurus cache and generated files
+
+.docusaurus
+
+# Serverless directories
+
+.serverless/
+
+# FuseBox cache
+
+.fusebox/
+
+# DynamoDB Local files
+
+.dynamodb/
+
+# TernJS port file
+
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+
+.vscode-test
+
+# yarn v2
+
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store
+
+bin
+mcp
+CLAUDE.md
+*.bun-build

.prettierignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+mcp/node_modules
+tts-audio
+.github
+bun.lockb

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "es5"
+}

CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# tts-cli
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run src/index.ts
+```
+
+This project was created using `bun init` in bun v1.2.1. [Bun](https://bun.sh) is a fast all-in-one JavaScript runtime.

README.md

@@ -0,0 +1,94 @@
+# Hume TTS CLI
+
+This is a CLI for Hume AI's [Octave TTS](https://hume.ai/blog/octave-the-first-text-to-speech-model-that-understands-what-it-s-saying) API.
+
+Unlike conventional TTS that merely "reads" words, Octave is a speech-language model that understands what words mean in context, unlocking a new level of expressiveness. It acts out characters, generates voices from prompts, and takes instructions to modify the emotion and style of a given utterance.
+
+This CLI uses Hume's [Typescript SDK](https://github.com/humeai/hume-typescript-sdk) behind the scenes.
+
+## Quickstart
+
+```shell
+npm install -g @humeai-cli
+hume login
+# Use the browser to login to platform.hume.ai to retrieve your
+# API keys
+hume tts "Are you serious?" --description "whispered, hushed"
+hume voices create --name whisperer --last
+hume tts "I said, are you serious?" --voice-name whisperer
+```
+
+## Installation
+
+The Hume CLI is distributed [via NPM](https://www.npmjs.com/package/@humeai/cli). You can install it globally via:
+
+```shell
+npm install -g @humeai/cli
+```
+
+## Usage
+
+```
+Text to speech
+
+━━━ Usage ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+$ hume tts <text>
+
+━━━ Options ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  -d,--description #0                         Description of the desired voice
+  -c,--continue,--context-generation-id #0    Previous generation ID for continuation
+  -l,--last,--continue-from-last              Use a generation from a previous synthesis as context. If the last synthesis was created with --num-generations > 1, you must also provide --last-index
+  --last-index #0                             Index of the generation to use from the previous synthesis.
+  -o,--output-dir #0                          Output directory for generated audio files
+  -n,--num-generations #0                     Number of variations to generate
+  -p,--prefix #0                              Filename prefix for generated audio
+  --play #0                                   Play audio after generation: all variations, just the first, or none
+  --play-command #0                           Command to play audio files (uses $AUDIO_FILE as placeholder for file path)
+  --api-key #0                                Override the default API key
+  --format #0                                 Output audio format
+  -v,--voice-name #0                          Name of a previously saved voice
+  --voice-id #0                               Direct voice ID to use
+  --json                                      Output in JSON format
+  --pretty                                    Output in human-readable format
+  --base-url #0                               Override the default API base URL (for testing purposes)
+
+━━━ Details ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+This command converts text to speech using Hume AI's advanced AI voice
+synthesis. You can specify voice characteristics through descriptions or use
+saved voices.
+
+━━━ Examples ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Basic usage
+  $ hume tts "Make sure to like and subscribe!" --description "The speaker is a charismatic, enthusiastic, male YouTuber in his 20s with a American accent, a slightly breathy voice, and a fast speaking rate."
+
+Saving a voice you like (see `hume voices create --help`)
+  $ hume voices create --name influencer_1 --last
+
+Using a previously-saved voice
+  $ hume tts "Thanks for the 100,000,000,000 likes guys!" -v influencer_1
+
+Reading from stdin
+  $ echo "I wouldn't be here without you" | hume tts - -v influencer_1
+
+Continuing previous text
+  $ hume tts "Take some arrows from the quiver" -v influencer_1
+  $ hume tts "Take a bow, too" -v influencer_1 --last # should rhyme with 'toe' not 'cow'
+
+Using custom audio player (macOS/Linux)
+  $ hume tts "Hello world" -v narrator --play-command "mpv $AUDIO_FILE --no-video"
+
+Using custom audio player (Windows)
+  $ hume tts "Hello world" -v narrator --play-command "powershell -c \"[System.Media.SoundPlayer]::new('$AUDIO_FILE').PlaySync()\""
+
+Setting a custom audio player for the session
+  $ hume session set tts.playCommand "vlc $AUDIO_FILE --play-and-exit"
+
+━━━ See also ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  * `hume voices create --help` - Save a voice for later use
+  * `hume session --help` - Save settings temporarily so you don't have to repeat yourself
+  * `hume config --help` - Save settings more permanently
+```