nova-audio-agent 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -44
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,57 +2,65 @@
|
|
|
2
2
|
|
|
3
3
|
**An always-on voice agent with restrained proactivity and voice-controlled workspaces.**
|
|
4
4
|
|
|
5
|
+
[](https://www.npmjs.com/package/nova-audio-agent)
|
|
6
|
+
[](https://github.com/deepnovacore/NovaAudioAgent/blob/main/LICENSE)
|
|
7
|
+
[](https://nodejs.org)
|
|
8
|
+
|
|
9
|
+
[Website](https://deepnovacore.github.io/NovaAudioAgent/en) ·
|
|
5
10
|
[GitHub](https://github.com/deepnovacore/NovaAudioAgent) ·
|
|
6
11
|
[简体中文](https://github.com/deepnovacore/NovaAudioAgent/blob/main/README.zh-CN.md) ·
|
|
7
|
-
[Watch the demo (Chinese)](https://youtu.be/t1c-2O-QsxE)
|
|
8
|
-
[Desktop downloads](https://github.com/deepnovacore/NovaAudioAgent/releases)
|
|
12
|
+
[Watch the demo (Chinese)](https://youtu.be/t1c-2O-QsxE)
|
|
9
13
|
|
|
10
14
|
Nova (小诺) keeps a conversation going while longer tasks run in the background.
|
|
11
|
-
It
|
|
12
|
-
|
|
15
|
+
It reports useful milestones, clarifies requests, and lets you steer work through
|
|
16
|
+
voice without narrating every small step.
|
|
17
|
+
|
|
18
|
+
|
|
13
19
|
|
|
14
|
-
This
|
|
15
|
-
desktop application. You do not need to clone or build the repository
|
|
20
|
+
This package provides the `novaaudio` command, which installs and launches the
|
|
21
|
+
desktop application. You do not need to clone or build the repository.
|
|
16
22
|
|
|
17
|
-
##
|
|
23
|
+
## Install
|
|
18
24
|
|
|
19
|
-
|
|
20
|
-
or **Windows x64**.
|
|
25
|
+
Requires **Node.js 22.13.0 or newer**, npm, and either **macOS on Apple Silicon**
|
|
26
|
+
or **Windows x64**. Intel Macs and Linux are not covered by the desktop build.
|
|
27
|
+
The application is not yet signed, so macOS Gatekeeper and Windows SmartScreen
|
|
28
|
+
will warn on first launch.
|
|
21
29
|
|
|
22
30
|
```bash
|
|
23
31
|
npm install --global nova-audio-agent
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## Configure
|
|
35
|
+
|
|
36
|
+
Open the desktop settings, which downloads the app on first run:
|
|
37
|
+
|
|
38
|
+
```bash
|
|
24
39
|
novaaudio config
|
|
25
40
|
```
|
|
26
41
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
[
|
|
30
|
-
|
|
31
|
-
[setup guide](https://github.
|
|
32
|
-
|
|
42
|
+
Then add the keys for the services you want:
|
|
43
|
+
|
|
44
|
+
- **[DashScope](https://platform.qianwenai.com)** — the default Qwen realtime voice service. Required.
|
|
45
|
+
- **[Tavily](https://docs.tavily.com)** — web search. Optional.
|
|
46
|
+
- **Codex** — a logged-in Codex executable, for coding tasks. Optional. See the [setup guide](https://deepnovacore.github.io/NovaAudioAgent/en/docs/getting-started).
|
|
47
|
+
|
|
48
|
+
Allow microphone access when prompted.
|
|
49
|
+
|
|
50
|
+
## Run
|
|
33
51
|
|
|
34
52
|
```bash
|
|
35
53
|
novaaudio
|
|
36
54
|
```
|
|
37
55
|
|
|
38
|
-
Hover over the desktop orb to
|
|
39
|
-
`novaaudio config`, or inspect your local setup with `novaaudio doctor`.
|
|
56
|
+
Hover over the desktop orb to reach its controls.
|
|
40
57
|
|
|
41
58
|
## Why Nova?
|
|
42
59
|
|
|
43
|
-
- **Talk while work continues.** Long-running tasks execute in the background
|
|
44
|
-
|
|
45
|
-
- **
|
|
46
|
-
|
|
47
|
-
- **Manage workspaces by voice.** Create or switch workspaces and sessions
|
|
48
|
-
through proposals that you confirm.
|
|
49
|
-
- **Steer ongoing work.** The Codex integration uses its native app-server
|
|
50
|
-
transport to support real-time steering.
|
|
51
|
-
|
|
52
|
-
The repository also documents ongoing development. Features and acceptance
|
|
53
|
-
status on development branches may differ from the shipped desktop release;
|
|
54
|
-
check the [release notes](https://github.com/deepnovacore/NovaAudioAgent/releases)
|
|
55
|
-
for your installed version.
|
|
60
|
+
- **Talk while work continues.** Long-running tasks execute in the background while Nova stays available for conversation.
|
|
61
|
+
- **Progress worth hearing.** Restrained proactivity surfaces meaningful updates instead of reading out every coding event.
|
|
62
|
+
- **Manage workspaces by voice.** Create or switch workspaces and sessions through proposals you confirm.
|
|
63
|
+
- **Steer ongoing work.** The Codex integration uses its native app-server transport, so you can redirect a task while it runs.
|
|
56
64
|
|
|
57
65
|
## Commands
|
|
58
66
|
|
|
@@ -64,25 +72,21 @@ for your installed version.
|
|
|
64
72
|
| `novaaudio --version` | Print the desktop release version used by the CLI |
|
|
65
73
|
| `novaaudio --help` | Show command help |
|
|
66
74
|
|
|
67
|
-
##
|
|
68
|
-
|
|
69
|
-
The CLI downloads the matching `v0.2.0` desktop release from
|
|
70
|
-
[GitHub Releases](https://github.com/deepnovacore/NovaAudioAgent/releases/tag/v0.2.0)
|
|
71
|
-
into `~/.nova-audio-agent/cli/releases/` and verifies its published SHA-256 digest
|
|
72
|
-
before launching it. It reuses the desktop client's encrypted settings store;
|
|
73
|
-
the CLI does not read or print secret values.
|
|
75
|
+
## How it works
|
|
74
76
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
+
The CLI downloads the matching desktop release from
|
|
78
|
+
[GitHub Releases](https://github.com/deepnovacore/NovaAudioAgent/releases) into
|
|
79
|
+
`~/.nova-audio-agent/cli/releases/` and verifies its published SHA-256 digest
|
|
80
|
+
before launching it. It reuses the desktop client's encrypted settings store and
|
|
81
|
+
never reads or prints secret values.
|
|
77
82
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
macOS Gatekeeper or Windows SmartScreen may display a security warning.
|
|
83
|
+
Run `novaaudio doctor` to see which release is installed and whether your
|
|
84
|
+
configuration is complete.
|
|
81
85
|
|
|
82
86
|
## Learn more
|
|
83
87
|
|
|
84
|
-
- [Getting started and integrations](https://github.
|
|
85
|
-
- [
|
|
88
|
+
- [Getting started and integrations](https://deepnovacore.github.io/NovaAudioAgent/en/docs/getting-started)
|
|
89
|
+
- [How Nova works](https://deepnovacore.github.io/NovaAudioAgent/en/docs/architecture)
|
|
86
90
|
- [Design: when should a proactive voice agent speak?](https://github.com/deepnovacore/NovaAudioAgent/blob/main/docs/en/blog/2026-08-proactive-voice-agent-design-space.md)
|
|
87
91
|
- [Report an issue](https://github.com/deepnovacore/NovaAudioAgent/issues)
|
|
88
92
|
- [Build from source and contribute](https://github.com/deepnovacore/NovaAudioAgent/blob/main/CONTRIBUTING.md)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nova-audio-agent",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Install and launch the Nova Audio Agent desktop client from the command line.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
"type": "git",
|
|
28
28
|
"url": "git+https://github.com/deepnovacore/NovaAudioAgent.git"
|
|
29
29
|
},
|
|
30
|
-
"homepage": "https://github.
|
|
30
|
+
"homepage": "https://deepnovacore.github.io/NovaAudioAgent/",
|
|
31
31
|
"bugs": {
|
|
32
32
|
"url": "https://github.com/deepnovacore/NovaAudioAgent/issues"
|
|
33
33
|
},
|