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.
Files changed (2) hide show
  1. package/README.md +59 -103
  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,38 +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.
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
- ### Cloud
92
+ **Cloud:** [Apteva Cloud](https://apteva.ai/cloud) runs the same platform without managing the server yourself.
133
93
 
134
- [Apteva Cloud](https://apteva.ai/cloud) runs the same platform without managing the server yourself.
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
- ## Bring your models
96
+ ## Build on Apteva
137
97
 
138
- 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.
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
- ## Repositories
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
- | [`apteva/apteva`](https://github.com/apteva/apteva) | CLI, installer, local lifecycle, and releases |
145
- | [`apteva/core`](https://github.com/apteva/core) | Persistent agent runtime and thinking loop |
146
- | [`apteva/server`](https://github.com/apteva/server) | Management API, agent orchestration, apps, and embedded dashboard |
147
- | [`apteva/dashboard`](https://github.com/apteva/dashboard) | React administration and operations UI |
148
- | [`apteva/integrations`](https://github.com/apteva/integrations) | Integration catalog, OAuth, webhooks, and MCP generation |
149
- | [`apteva/apps`](https://github.com/apteva/apps) | First-party operational apps |
150
- | [`apteva/app-sdk`](https://github.com/apteva/app-sdk) | Go SDK for building Apteva apps |
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
- ## Community
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
- 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.
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
- <p align="center">
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.79.0",
4
- "description": "AI agent platform with multi-thread orchestration, MCP integrations, and dashboard",
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
- "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
  }