reasonkit-core 0.1.8

The Reasoning Engine — Auditable Reasoning for Production AI | Rust-Native | Turn Prompts into Protocols
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

# ReasonKit Core Examples

This directory contains runnable examples demonstrating various features of ReasonKit Core.

## Quick Start Examples

### GLM-4.6 Integration

**`glm46_quick_start.rs`** - Complete GLM-4.6 integration example

```bash
# Set API key
export GLM46_API_KEY="your-api-key-here"

# Run example
cargo run --example glm46_quick_start
```

**Features demonstrated:**

- Basic client setup and configuration
- Chat completion with GLM-4.6
- Structured output for agent coordination
- Cost tracking and optimization
- Error handling patterns

**Prerequisites:**

- `GLM46_API_KEY` environment variable set
- GLM-4.6 API access (via OpenRouter or direct)

### Core ThinkTool Protocol

**`quick-start-core.rs`** - Basic ThinkTool protocol usage

```bash
cargo run --example quick-start-core
```

**Features demonstrated:**

- Protocol creation and execution
- Reasoning strategies
- Step-by-step reasoning process

## Integration Examples

### Memory Service

**`memory_service_example.rs`** - Memory service integration

```bash
cargo run --example memory_service_example --features memory
```

### Web Adapter

**`web_adapter_example.rs`** - Web adapter usage

```bash
cargo run --example web_adapter_example
```

### M2 Integration

**`m2_integration_example.rs`** - Minimax M2 model integration

```bash
cargo run --example m2_integration_example --features minimax
```

## Advanced Examples

### Aesthetic Demo

**`aesthetic_demo.rs`** - Aesthetic engine demonstration

```bash
cargo run --example aesthetic_demo --features aesthetic
```

### Vibe Quick Start

**`vibe_quick_start.rs`** - Vibe engine quick start

```bash
cargo run --example vibe_quick_start --features vibe
```

### Power Combo

**`powercombo.rs`** - Combined features demonstration

```bash
cargo run --example powercombo
```

## Running Examples

### Basic Run

```bash
cargo run --example <example-name>
```

### With Features

```bash
cargo run --example <example-name> --features <feature1>,<feature2>
```

### With Environment Variables

```bash
GLM46_API_KEY="your-key" cargo run --example glm46_quick_start
```

## Example Categories

| Category        | Examples                                                                  | Purpose              |
| --------------- | ------------------------------------------------------------------------- | -------------------- |
| **Quick Start** | `glm46_quick_start`, `quick-start-core`                                   | Get started quickly  |
| **Integration** | `memory_service_example`, `web_adapter_example`, `m2_integration_example` | Integration patterns |
| **Advanced**    | `aesthetic_demo`, `vibe_quick_start`, `powercombo`                        | Advanced features    |

## Contributing Examples

When adding new examples:

1. Create example file in `examples/` directory
2. Add `[[example]]` entry to `Cargo.toml`
3. Include comprehensive documentation comments
4. Add to this README
5. Test that example compiles and runs

## Documentation

For more detailed documentation:

- **GLM-4.6 Integration**: See `src/glm46/INTEGRATION_GUIDE.md`
- **API Reference**: Run `cargo doc --open`
- **Getting Started**: See `GETTING_STARTED.md`

---

**Last Updated:** 2026-01-02