spec-ai-api 0.4.16

HTTP API for spec-ai framework
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# spec-ai-api

HTTP API server for the spec-ai framework.

## Overview

This crate provides a REST API and mesh server for remote agent interaction and coordination. It enables:

- **HTTP API**: RESTful endpoints for agent interaction
- **Mesh Server**: Distributed agent coordination and synchronization
- **Remote Access**: Network-based agent communication
- **Session Management**: Multi-session support with isolated contexts

## Technology Stack

Built on modern async Rust web technologies:

- **axum** - Fast, ergonomic web framework
- **tower** - Modular service layers and middleware
- **tokio** - Async runtime
- **serde** - JSON serialization/deserialization

## Features

The API server provides:

- Agent chat endpoints
- Session management
- Tool execution via HTTP
- Real-time streaming responses
- Multi-agent coordination
- CORS support for web clients

## Dependencies

This crate depends on:
- `spec-ai-core` - Core agent runtime (with `api` feature enabled)
- `spec-ai-config` - Configuration management
- `spec-ai-policy` - Policy enforcement for API requests

## Usage

Enable the API server using the `api` feature flag:

```bash
cargo install spec-ai --features api
```

The API server is automatically started when configured in `spec-ai.config.toml`.

## Testing

Run API-specific tests:

```bash
cargo test --features api
```

For end-user documentation, see the main [spec-ai README](../../README.md).