apteva 0.79.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 +59 -103
- 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,38 +87,34 @@ docker run -d \
|
|
|
127
87
|
ghcr.io/apteva/apteva:latest
|
|
128
88
|
```
|
|
129
89
|
|
|
130
|
-
|
|
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.
|
|
131
91
|
|
|
132
|
-
|
|
92
|
+
**Cloud:** [Apteva Cloud](https://apteva.ai/cloud) runs the same platform without managing the server yourself.
|
|
133
93
|
|
|
134
|
-
|
|
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.
|
|
135
95
|
|
|
136
|
-
##
|
|
96
|
+
## Build on Apteva
|
|
137
97
|
|
|
138
|
-
|
|
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.
|
|
139
99
|
|
|
140
|
-
|
|
100
|
+
[Browse apps](https://apteva.ai/apps) · [Build an app](https://apteva.ai/developers/apps) · [Platform API](https://apteva.ai/developers/api)
|
|
101
|
+
|
|
102
|
+
This repository contains the **CLI, npm installer, local lifecycle, and platform release pipeline**. The rest of the operating system lives in companion repositories:
|
|
141
103
|
|
|
142
104
|
| Repository | Role |
|
|
143
105
|
|---|---|
|
|
144
|
-
| [
|
|
145
|
-
| [
|
|
146
|
-
| [
|
|
147
|
-
| [
|
|
148
|
-
| [
|
|
149
|
-
| [
|
|
150
|
-
| [
|
|
151
|
-
| [`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 |
|
|
152
113
|
|
|
153
|
-
|
|
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).
|
|
154
115
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
If Apteva helps you build agents that do real work, [star the repository](https://github.com/apteva/apteva) so more builders can find it.
|
|
116
|
+
## Community
|
|
158
117
|
|
|
159
|
-
|
|
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.
|
|
160
119
|
|
|
161
|
-
|
|
162
|
-
<strong>Build agents that operate, not just respond.</strong><br />
|
|
163
|
-
<a href="https://apteva.ai">apteva.ai</a>
|
|
164
|
-
</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
|
}
|