File size: 3,380 Bytes
297e6ed
e857958
297e6ed
 
 
0437898
297e6ed
 
 
 
 
0437898
297e6ed
8d9d361
297e6ed
 
 
8d9d361
 
 
 
0437898
8d9d361
0437898
8d9d361
0437898
8d9d361
 
 
 
 
 
0437898
8d9d361
0437898
 
297e6ed
0437898
8d9d361
0437898
8d9d361
0437898
8d9d361
 
 
 
0437898
 
 
 
8d9d361
0437898
 
 
8d9d361
 
0437898
 
 
 
 
8d9d361
 
e14bba5
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
297e6ed
30cffb8
0437898
30cffb8
0437898
 
 
30cffb8
0437898
 
 
30cffb8
297e6ed
 
 
0437898
297e6ed
0437898
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
---
title: cluas_huginn
emoji: 💬
colorFrom: yellow
colorTo: purple
sdk: docker
pinned: false
hf_oauth: true
hf_oauth_scopes:
- inference-api
license: apache-2.0
short_description: A gathering of guides, a council of counsels
---

An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).


the above is just a template readme they gave me when I created this space on hugging face, feel free to ignore it.


# 🐦‍⬛ Cluas
*A gathering of guides, a council of counsels*

> **Clúas** (Gaelic: "ear") — a dialectic research tool where AI experts collaborate, remember, and build knowledge over time.

## What it Does

Corvid Council is a multi-agent MCP system that enables dialectic research 
through collaborative AI agents. Present a question to the council and watch 
as four specialized experts research, debate, and synthesize knowledge—building 
on past discussions through shared memory.

### Modes

- **Collaborative Mode**: Ask a question and receive synthesized research with sources  
- **Active Mode**: Join the discussion, steer research, challenge claims

### Dialectic Process

1. **Thesis**: Characters present initial findings using specialized tools  
2. **Antithesis**: Characters challenge, verify, and provide counter-evidence  
3. **Synthesis**: Council builds consensus and adds to collective memory  
4. **Evolution**: Future discussions build on accumulated knowledge

### Why It Matters

Most AI assistants are stateless. cluas_huginn Council remembers, learns, and builds knowledge over time.


### Characters

- Corvus: 🐦‍⬛ (black bird)  
- Magpie: 🪶 (feather, playful)  
- Raven: 🦅 (eagle, serious)  
- Crow: 🕊️ (dove, peaceful observer)

### Taglines

- "A gathering of guides, a council of counsels"  
- "Research that remembers, knowledge that accumulates"  
- "Multi-agent MCP research collective"


v2:

# Cluas Huginn: Multi-Agent Dialectic System

## What It Does
Four AI agents with distinct roles debate questions using structured dialectic.

## Architecture
- **Corvus**: Academic verifier (literature search)
- **Raven**: Accountability enforcer (news verification)
- **Magpie**: Trend explorer (pattern connector)
- **Crow**: Grounded observer (environmental data)

## Key Innovations
1. Unified inheritance architecture
2. Shared epistemic principles with character differentiation
3. Tool-use heuristics per character
4. Steelmanning and collaborative disagreement built-in

## Tech Stack
- Base: Python, Gradio
- LLMs: Groq/Nebius (Qwen 3)
- Tools: Academic search, news verification, web exploration
- Memory: Persistent character memories

## What Makes This Different
- Not just multiple LLMs - distinct epistemic roles
- Structured dialectic (thesis/antithesis/synthesis)
- Tool usage guided by character personality
- Collaborative, not adversarial












## Hackathon Track Entries

- "building-mcp-track-enterprise" → Track 1
- "building-mcp-track-consumer" → Track 1
- "building-mcp-track-creative" → Track 1

- "mcp-in-action-track-enterprise" → Track 2
- "mcp-in-action-track-consumer" → Track 2
- "mcp-in-action-track-creative" → Track 2




---

This project is licensed under the [Apache 2.0 License](LICENSE).