ruvector-tiny-dancer-core 2.0.6

Production-grade AI agent routing system with FastGRNN neural inference
Documentation 
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

# Tiny Dancer Examples

This directory contains example applications demonstrating how to use Tiny Dancer.

## Admin Server Example

**File:** `admin-server.rs`

A production-ready admin API server with health checks, metrics, and administration endpoints.

### Features

- Health check endpoints (K8s liveness & readiness probes)
- Prometheus metrics export
- Hot model reloading
- Configuration management
- Circuit breaker monitoring
- Optional bearer token authentication

### Running

```bash
cargo run --example admin-server --features admin-api
```

### Testing

Once running, test the endpoints:

```bash
# Health check
curl http://localhost:8080/health

# Readiness check
curl http://localhost:8080/health/ready

# Prometheus metrics
curl http://localhost:8080/metrics

# System information
curl http://localhost:8080/info
```

### Admin Endpoints

Admin endpoints support optional authentication:

```bash
# Reload model (if auth enabled)
curl -X POST http://localhost:8080/admin/reload \
  -H "Authorization: Bearer your-token-here"

# Get configuration
curl http://localhost:8080/admin/config \
  -H "Authorization: Bearer your-token-here"

# Circuit breaker status
curl http://localhost:8080/admin/circuit-breaker \
  -H "Authorization: Bearer your-token-here"
```

### Configuration

Edit the example to configure:
- Bind address and port
- Authentication token
- CORS settings
- Router configuration

### Production Deployment

For production use:

1. **Enable authentication:**
   ```rust
   auth_token: Some("your-secret-token".to_string())
   ```

2. **Use environment variables:**
   ```rust
   let token = std::env::var("ADMIN_AUTH_TOKEN").ok();
   ```

3. **Deploy behind HTTPS proxy** (nginx, Envoy, etc.)

4. **Set up Prometheus scraping:**
   ```yaml
   scrape_configs:
     - job_name: 'tiny-dancer'
       static_configs:
         - targets: ['localhost:8080']
   ```

5. **Configure Kubernetes probes:**
   ```yaml
   livenessProbe:
     httpGet:
       path: /health
       port: 8080
   readinessProbe:
     httpGet:
       path: /health/ready
       port: 8080
   ```

## Documentation

- [Admin API Full Documentation](../docs/API.md)
- [Quick Start Guide](../docs/ADMIN_API_QUICKSTART.md)

## Next Steps

1. Integrate with your application
2. Set up monitoring (Prometheus + Grafana)
3. Configure alerts
4. Deploy to production

## Support

For issues or questions, see the main repository documentation.