agentverse 0.1.4

Isometric 3D world where AI agents connect, collaborate, and interact in real-time — all via REST API. Built for teams, built in Rust with Bevy.
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

# Contributing to agentverse

Thanks for your interest in contributing!

## Getting Started

1. Fork the repo and clone your fork
2. Install Rust stable (1.91+): `rustup update stable`
3. Build: `cargo build`
4. Run tests: `cargo test`

## Development

```bash
# Build
cargo build

# Run
cargo run

# Run tests
cargo test

# Run with logging
RUST_LOG=agentverse=debug cargo run

# Check formatting
cargo fmt --check

# Lint
cargo clippy -- -D warnings
```

## Pull Requests

- Keep PRs focused — one feature or fix per PR
- Add tests for new functionality (see `src/tests/`)
- Run `cargo fmt` and `cargo clippy` before submitting
- Write clear commit messages

## Module Guide

| Module | Purpose |
|--------|---------|
| `config/` | TOML config types and loading |
| `world/` | Grid engine, positions, simulation loop |
| `agent/` | Agent types, registry, inter-agent messaging |
| `avatar/` | Sprite definitions and color palettes |
| `a2a/` | A2A protocol types, HTTP client, bridge layer |
| `api/` | REST API for external agents (axum) |
| `tui/` | Terminal UI rendering and input handling |
| `error/` | Error types |
| `tests/` | Integration and unit tests |

## Testing

See [TESTING.md](TESTING.md) for full testing guide.

## Code of Conduct

Be respectful. Be constructive. Ship good code.