apteva 0.80.0 → 0.82.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.
Files changed (2) hide show
  1. package/README.md +58 -117
  2. 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
- Give agents goals. They remember context, react to events, schedule and resume work,<br />
19
- delegate to workers, and operate through apps and 590+ integrations.
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/get-started">Docs</a> ·
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/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/apteva/apteva/release.yml?style=flat-square&label=release" alt="Release status" /></a>
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+. The installer downloads the current native release. Connect a model provider, create an agent, and Apteva opens the local dashboard.
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
- Apteva runs locally by default. Your agents, credentials, memory, and operational data stay under your control.
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
- Local country lookup is enabled by default using DB-IP Country Lite, downloaded
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
- ## Agents are easy to demo. Hard to operate.
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
- A prototype agent can call a tool. A production agent also needs durable state, memory, permissions, events, schedules, workers, retries, dashboards, integrations, and deployment.
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
- Apteva packages that operating layer into one workspace. Instead of rebuilding the same infrastructure for every agent, you get a complete system for ongoing operations.
55
+ <p align="center"><sub>Product concept illustrations from <a href="https://apteva.ai">apteva.ai</a>.</sub></p>
62
56
 
63
- | | What Apteva provides |
57
+ | | What you get |
64
58
  |---|---|
65
- | **Keeps working** | Agents react to events, follow up on unresolved work, and continue across hours or days. |
66
- | **Durable by default** | Tasks, schedules, history, memory, and progress survive restarts and closed chats. |
67
- | **A complete operating layer** | Runtime, server, dashboard, channels, apps, integrations, files, logs, and deployment work together. |
68
- | **Apps, not just tool wrappers** | One app can add tools, UI panels, routes, workers, channels, memory, and domain workflows. |
69
- | **Multi-agent operations** | Agents delegate bounded work to dedicated workers while retaining durable ownership and visibility. |
70
- | **Control where it runs** | Use Apteva locally, self-host it on a VPS or Docker, or run it on Apteva Cloud. |
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
- ## What agents can operate
66
+ ## Give an agent a responsibility
73
67
 
74
- | Operation | Examples |
75
- |---|---|
76
- | **Customer support** | Triage tickets, search knowledge bases, draft replies, and escalate when human judgment is needed. |
77
- | **Sales and CRM** | Enrich leads, schedule follow-ups, update pipelines, and surface deals that need attention. |
78
- | **Content and growth** | Research, create assets, publish across channels, and monitor performance. |
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
- The CLI installs and starts the platform. The server manages authentication, projects, agent runtimes, apps, connections, events, and the dashboard. Each agent core owns its thinking loop, threads, tools, memory, and persistent history.
74
+ [Explore use cases →](https://apteva.ai/use-cases)
111
75
 
112
76
  ## Run it your way
113
77
 
114
- ### Local
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
- ### Docker
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
- Then open [http://localhost:5280](http://localhost:5280). Pin a numbered image tag instead of `latest` for production deployments.
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
- ### Your domain and HTTPS
92
+ **Cloud:** [Apteva Cloud](https://apteva.ai/cloud) runs the same platform without managing the server yourself.
137
93
 
138
- Use **Settings → Server → Domain & HTTPS** or `apteva https setup` for a guided
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
- Use `apteva https setup --help` for Cloudflare, certificate import, listener ports
149
- and instance selection. A new public URL activates only after HTTPS verification.
96
+ ## Build on Apteva
150
97
 
151
- ## Bring your models
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
- Use hosted or local models, choose different providers per project, and switch models without rebuilding your agents. Apteva supports OpenAI, Anthropic, Google, Fireworks, Ollama, NVIDIA, Venice, xAI, and other compatible providers.
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
- ## Repositories
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
- | [`apteva/apteva`](https://github.com/apteva/apteva) | CLI, installer, local lifecycle, and releases |
160
- | [`apteva/core`](https://github.com/apteva/core) | Persistent agent runtime and thinking loop |
161
- | [`apteva/server`](https://github.com/apteva/server) | Management API, agent orchestration, apps, and embedded dashboard |
162
- | [`apteva/dashboard`](https://github.com/apteva/dashboard) | React administration and operations UI |
163
- | [`apteva/integrations`](https://github.com/apteva/integrations) | Integration catalog, OAuth, webhooks, and MCP generation |
164
- | [`apteva/apps`](https://github.com/apteva/apps) | First-party operational apps |
165
- | [`apteva/app-sdk`](https://github.com/apteva/app-sdk) | Go SDK for building Apteva apps |
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
- ## Community
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
- 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
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
- <p align="center">
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.80.0",
4
- "description": "AI agent platform with multi-thread orchestration, MCP integrations, and dashboard",
3
+ "version": "0.82.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
- "agent",
13
+ "ai-agents",
14
+ "ai-operating-system",
15
+ "self-hosted",
14
16
  "mcp",
15
- "orchestration",
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
  }