apteva 0.80.0 → 0.81.0
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 +58 -117
- package/package.json +8 -5
package/README.md
CHANGED
|
@@ -1,27 +1,19 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<a href="https://apteva.ai">
|
|
3
|
-
<img src="https://apteva.ai/icon.png" width="96" alt="Apteva logo" />
|
|
4
|
-
</a>
|
|
2
|
+
<a href="https://apteva.ai"><img src="https://apteva.ai/icon.png" width="80" alt="Apteva logo" /></a>
|
|
5
3
|
</p>
|
|
6
4
|
|
|
7
5
|
<h1 align="center">Apteva</h1>
|
|
8
6
|
|
|
9
|
-
<p align="center">
|
|
10
|
-
<strong>AI agents, batteries included.</strong>
|
|
11
|
-
</p>
|
|
12
|
-
|
|
13
|
-
<p align="center">
|
|
14
|
-
The open-source, self-hosted platform for agents that keep working after the chat ends.
|
|
15
|
-
</p>
|
|
7
|
+
<p align="center"><strong>The open-source AI operating system.</strong></p>
|
|
16
8
|
|
|
17
9
|
<p align="center">
|
|
18
|
-
|
|
19
|
-
|
|
10
|
+
Run persistent agents, install apps, and connect your tools in one workspace.<br />
|
|
11
|
+
Agents remember, schedule work, and act—with permissions and activity you can inspect.
|
|
20
12
|
</p>
|
|
21
13
|
|
|
22
14
|
<p align="center">
|
|
23
15
|
<a href="https://apteva.ai">Website</a> ·
|
|
24
|
-
<a href="https://docs.apteva.ai/
|
|
16
|
+
<a href="https://docs.apteva.ai/">Documentation</a> ·
|
|
25
17
|
<a href="https://apteva.ai/apps">Apps</a> ·
|
|
26
18
|
<a href="https://apteva.ai/cloud">Cloud</a> ·
|
|
27
19
|
<a href="https://discord.gg/apteva">Discord</a>
|
|
@@ -30,94 +22,62 @@
|
|
|
30
22
|
<p align="center">
|
|
31
23
|
<a href="https://github.com/apteva/apteva/releases/latest"><img src="https://img.shields.io/github/v/release/apteva/apteva?style=flat-square" alt="Latest release" /></a>
|
|
32
24
|
<a href="https://www.npmjs.com/package/apteva"><img src="https://img.shields.io/npm/v/apteva?style=flat-square" alt="npm version" /></a>
|
|
33
|
-
<a href="https://github.com/apteva/apteva/actions/workflows/
|
|
34
|
-
<a href="https://github.com/apteva/apteva"><img src="https://img.shields.io/github/stars/apteva/apteva?style=flat-square" alt="GitHub stars" /></a>
|
|
25
|
+
<a href="https://github.com/apteva/apteva/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/apteva/apteva/ci.yml?style=flat-square&label=tests" alt="CLI checks" /></a>
|
|
35
26
|
</p>
|
|
36
27
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
## Start in 30 seconds
|
|
28
|
+
## Get started
|
|
40
29
|
|
|
41
30
|
```bash
|
|
42
31
|
npx apteva
|
|
43
32
|
```
|
|
44
33
|
|
|
45
|
-
On macOS or Linux with Node.js 18+.
|
|
34
|
+
On macOS or Linux with Node.js 18+. Apteva downloads the native release and opens your local dashboard. Connect a model provider, create an agent, and give it a responsibility.
|
|
46
35
|
|
|
47
|
-
|
|
36
|
+
Self-host free on your own machine or infrastructure, or use [Apteva Cloud](https://apteva.ai/cloud) for a managed workspace. [Read the setup guide →](https://docs.apteva.ai/#quickstart)
|
|
48
37
|
|
|
49
|
-
|
|
50
|
-
anonymously and refreshed monthly. Use `apteva geoip setup --test` for
|
|
51
|
-
development, or provide a MaxMind account ID and license key to use GeoLite2
|
|
52
|
-
Country instead. Server refreshes configured databases in the background and
|
|
53
|
-
keeps serving with the last known-good copy if an update fails. DB-IP Country
|
|
54
|
-
Lite data is provided by [DB-IP](https://db-ip.com) under
|
|
55
|
-
[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
|
|
38
|
+
## An operating system around your agents
|
|
56
39
|
|
|
57
|
-
|
|
40
|
+
Apteva combines a persistent agent runtime, an app system, and a workspace that grows around what you install. Give agents ongoing responsibilities, connect the systems they need, and keep their work in view.
|
|
58
41
|
|
|
59
|
-
|
|
42
|
+
<table>
|
|
43
|
+
<tr>
|
|
44
|
+
<td width="33%"><img src="https://apteva.ai/product-concepts/persistent-agent.png" alt="Persistent agent concept: remembered context, a prepared reply, and a scheduled follow-up" /></td>
|
|
45
|
+
<td width="33%"><img src="https://apteva.ai/product-concepts/dashboard.png" alt="Dashboard concept: agent activity, tool usage, and decisions awaiting review" /></td>
|
|
46
|
+
<td width="33%"><img src="https://apteva.ai/product-concepts/apps.png" alt="App library concept: CRM, storage, code, tasks, and other installable apps" /></td>
|
|
47
|
+
</tr>
|
|
48
|
+
<tr>
|
|
49
|
+
<td align="center"><strong>Persistent agents</strong></td>
|
|
50
|
+
<td align="center"><strong>One workspace</strong></td>
|
|
51
|
+
<td align="center"><strong>Installable apps</strong></td>
|
|
52
|
+
</tr>
|
|
53
|
+
</table>
|
|
60
54
|
|
|
61
|
-
|
|
55
|
+
<p align="center"><sub>Product concept illustrations from <a href="https://apteva.ai">apteva.ai</a>.</sub></p>
|
|
62
56
|
|
|
63
|
-
| | What
|
|
57
|
+
| | What you get |
|
|
64
58
|
|---|---|
|
|
65
|
-
| **
|
|
66
|
-
| **
|
|
67
|
-
| **
|
|
68
|
-
| **
|
|
69
|
-
| **Multi-agent
|
|
70
|
-
| **
|
|
59
|
+
| **Agents that keep working** | Memory across conversations, events, scheduled follow-ups, and durable tasks that survive restarts. |
|
|
60
|
+
| **A workspace shaped by your apps** | Install CRM, storage, tasks, code, or other apps. Each can bring tools, its own UI, routes, channels, and workers. |
|
|
61
|
+
| **Connections to your tools** | Hundreds of integrations, including GitHub, Slack, Stripe, Shopify, HubSpot, Google Workspace, and databases. |
|
|
62
|
+
| **Control you can inspect** | Set goals and permissions, follow activity and tool calls, and review actions that need human judgment. |
|
|
63
|
+
| **Multi-agent work** | Delegate bounded tasks to workers while keeping progress and ownership visible. |
|
|
64
|
+
| **Your models and infrastructure** | Choose hosted or local models. Run locally, self-host, or use Cloud. |
|
|
71
65
|
|
|
72
|
-
##
|
|
66
|
+
## Give an agent a responsibility
|
|
73
67
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
| **Engineering and DevOps** | Watch deployments, investigate alerts, run tests, prepare patches, and coordinate incidents. |
|
|
80
|
-
| **Back-office work** | Process invoices, reconcile data, manage inventory, and coordinate vendors. |
|
|
81
|
-
| **Devices and edge systems** | Run the Go-based agent core close to browsers, machines, robots, and local infrastructure. |
|
|
82
|
-
|
|
83
|
-
## Apps turn agents into operators
|
|
84
|
-
|
|
85
|
-
Apteva apps extend the platform with any combination of:
|
|
86
|
-
|
|
87
|
-
- MCP tools and integrations
|
|
88
|
-
- Dashboard and chat UI
|
|
89
|
-
- HTTP routes and webhooks
|
|
90
|
-
- Background workers and scheduled jobs
|
|
91
|
-
- Channels, memory, and shared operational data
|
|
92
|
-
|
|
93
|
-
The current catalog contains **590+ integrations**, including GitHub, Slack, Stripe, Shopify, Airtable, Twilio, HubSpot, Google Workspace, cloud providers, databases, media tools, and model APIs.
|
|
94
|
-
|
|
95
|
-
[Browse apps](https://apteva.ai/apps) · [Explore the integrations repository](https://github.com/apteva/integrations) · [Build with the App SDK](https://github.com/apteva/app-sdk)
|
|
96
|
-
|
|
97
|
-
## How it works
|
|
98
|
-
|
|
99
|
-
```mermaid
|
|
100
|
-
flowchart LR
|
|
101
|
-
U["Dashboard, CLI, and channels"] --> S["Apteva server"]
|
|
102
|
-
E["Events, webhooks, and schedules"] --> S
|
|
103
|
-
S --> A["Persistent agent runtimes"]
|
|
104
|
-
A --> W["Durable tasks and workers"]
|
|
105
|
-
S --> P["Apps"]
|
|
106
|
-
P --> C["Tools, UI, routes, channels, and memory"]
|
|
107
|
-
P --> I["590+ integrations"]
|
|
108
|
-
```
|
|
68
|
+
- **Support:** triage incoming tickets, find answers, prepare replies, and escalate decisions.
|
|
69
|
+
- **Sales:** enrich leads, update your CRM, and follow up when a deal needs attention.
|
|
70
|
+
- **Content:** research topics, create assets, publish through connected tools, and track results.
|
|
71
|
+
- **Engineering:** monitor deployments, investigate alerts, run tests, and prepare fixes.
|
|
72
|
+
- **Operations:** process invoices, reconcile records, and coordinate recurring work.
|
|
109
73
|
|
|
110
|
-
|
|
74
|
+
[Explore use cases →](https://apteva.ai/use-cases)
|
|
111
75
|
|
|
112
76
|
## Run it your way
|
|
113
77
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
```bash
|
|
117
|
-
npx apteva
|
|
118
|
-
```
|
|
78
|
+
**Local:** run `npx apteva`. Your workspace data stays on your machine; hosted model providers and connected services receive the requests you send to them.
|
|
119
79
|
|
|
120
|
-
|
|
80
|
+
**Docker:** run the published image with persistent storage:
|
|
121
81
|
|
|
122
82
|
```bash
|
|
123
83
|
docker run -d \
|
|
@@ -127,53 +87,34 @@ docker run -d \
|
|
|
127
87
|
ghcr.io/apteva/apteva:latest
|
|
128
88
|
```
|
|
129
89
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
### Cloud
|
|
133
|
-
|
|
134
|
-
[Apteva Cloud](https://apteva.ai/cloud) runs the same platform without managing the server yourself.
|
|
90
|
+
Open [http://localhost:5280](http://localhost:5280). Pin a numbered image tag for production. See [deployment and HTTPS setup](docs/deployment.md) for your own domain.
|
|
135
91
|
|
|
136
|
-
|
|
92
|
+
**Cloud:** [Apteva Cloud](https://apteva.ai/cloud) runs the same platform without managing the server yourself.
|
|
137
93
|
|
|
138
|
-
Use
|
|
139
|
-
setup. Choose native automatic certificates, Cloudflare DNS validation, an
|
|
140
|
-
existing proxy/tunnel, or an imported certificate. No Domains app is required.
|
|
141
|
-
|
|
142
|
-
```bash
|
|
143
|
-
apteva https setup agents.example.com --accept-terms
|
|
144
|
-
apteva https status
|
|
145
|
-
apteva https doctor
|
|
146
|
-
```
|
|
94
|
+
Use OpenAI, Anthropic, Google, Fireworks, Ollama, NVIDIA, Venice, xAI, or other compatible model providers. Choose different providers per project and switch models without rebuilding your agents.
|
|
147
95
|
|
|
148
|
-
|
|
149
|
-
and instance selection. A new public URL activates only after HTTPS verification.
|
|
96
|
+
## Build on Apteva
|
|
150
97
|
|
|
151
|
-
|
|
98
|
+
Write an app with the [App SDK](https://github.com/apteva/app-sdk) to add tools, UI panels, HTTP routes, workers, channels, and operational data. Your app sits alongside the first-party apps in the same workspace.
|
|
152
99
|
|
|
153
|
-
|
|
100
|
+
[Browse apps](https://apteva.ai/apps) · [Build an app](https://apteva.ai/developers/apps) · [Platform API](https://apteva.ai/developers/api)
|
|
154
101
|
|
|
155
|
-
|
|
102
|
+
This repository contains the **CLI, npm installer, local lifecycle, and platform release pipeline**. The rest of the operating system lives in companion repositories:
|
|
156
103
|
|
|
157
104
|
| Repository | Role |
|
|
158
105
|
|---|---|
|
|
159
|
-
| [
|
|
160
|
-
| [
|
|
161
|
-
| [
|
|
162
|
-
| [
|
|
163
|
-
| [
|
|
164
|
-
| [
|
|
165
|
-
| [
|
|
166
|
-
| [`apteva/computer`](https://github.com/apteva/computer) | Browser and computer-use backends |
|
|
106
|
+
| [core](https://github.com/apteva/core) | Persistent agent runtime and thinking loop |
|
|
107
|
+
| [server](https://github.com/apteva/server) | Management API, orchestration, apps, and embedded dashboard |
|
|
108
|
+
| [dashboard](https://github.com/apteva/dashboard) | Administration and operations UI |
|
|
109
|
+
| [apps](https://github.com/apteva/apps) | First-party operational apps |
|
|
110
|
+
| [integrations](https://github.com/apteva/integrations) | Integration catalog, OAuth, webhooks, and MCP generation |
|
|
111
|
+
| [app-sdk](https://github.com/apteva/app-sdk) | Go SDK for building apps |
|
|
112
|
+
| [computer](https://github.com/apteva/computer) | Browser and computer-use backends |
|
|
167
113
|
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
Read the [documentation](https://docs.apteva.ai/get-started), join the [Discord community](https://discord.gg/apteva), or open an [issue](https://github.com/apteva/apteva/issues) for bugs and feature requests.
|
|
114
|
+
For source builds and the repository layout, start with the [development guide](docs/development.md). See also [app testing scenarios](docs/testing-scenarios.md) and [multi-agent topology tests](docs/test-topology.md).
|
|
171
115
|
|
|
172
|
-
|
|
116
|
+
## Community
|
|
173
117
|
|
|
174
|
-
|
|
118
|
+
Read the [documentation](https://docs.apteva.ai/), join [Discord](https://discord.gg/apteva), or open an [issue](https://github.com/apteva/apteva/issues) for bugs and feature requests.
|
|
175
119
|
|
|
176
|
-
|
|
177
|
-
<strong>Build agents that operate, not just respond.</strong><br />
|
|
178
|
-
<a href="https://apteva.ai">apteva.ai</a>
|
|
179
|
-
</p>
|
|
120
|
+
Open source. Yours to run.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "apteva",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "AI
|
|
3
|
+
"version": "0.81.0",
|
|
4
|
+
"description": "The open-source AI operating system for persistent agents, apps, and integrations",
|
|
5
5
|
"bin": {
|
|
6
6
|
"apteva": "./cli.js"
|
|
7
7
|
},
|
|
@@ -10,9 +10,11 @@
|
|
|
10
10
|
},
|
|
11
11
|
"keywords": [
|
|
12
12
|
"ai",
|
|
13
|
-
"
|
|
13
|
+
"ai-agents",
|
|
14
|
+
"ai-operating-system",
|
|
15
|
+
"self-hosted",
|
|
14
16
|
"mcp",
|
|
15
|
-
"
|
|
17
|
+
"automation",
|
|
16
18
|
"llm"
|
|
17
19
|
],
|
|
18
20
|
"license": "MIT",
|
|
@@ -26,5 +28,6 @@
|
|
|
26
28
|
"files": [
|
|
27
29
|
"cli.js",
|
|
28
30
|
"install.js"
|
|
29
|
-
]
|
|
31
|
+
],
|
|
32
|
+
"homepage": "https://apteva.ai"
|
|
30
33
|
}
|