Diomedes Git commited on
Commit
0437898
·
1 Parent(s): 18523d4

going dockerfile for the space, so i can use python3.13, also fixing up th readme a bit, it wasnt the neatest (could still do with a decent rewrite tbh).

Browse files
Files changed (1) hide show
  1. README.md +32 -36
README.md CHANGED
@@ -3,13 +3,13 @@ title: cluas_huginn
3
  emoji: 💬
4
  colorFrom: yellow
5
  colorTo: purple
6
- docker: true
7
  pinned: false
8
  hf_oauth: true
9
  hf_oauth_scopes:
10
  - inference-api
11
  license: apache-2.0
12
- short_description: a gathering of guides, a council of counsels
13
  ---
14
 
15
  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).
@@ -19,67 +19,63 @@ the above is just a template readme they gave me when I created this space on hu
19
 
20
 
21
  # 🐦‍⬛ Cluas
22
- ## *A gathering of guides, a council of counsels*
23
 
24
- > **Clúas** (Gaelic: "ear") - A dialectic research tool where AI experts
25
- > collaborate, remember, and build knowledge over time.
26
 
27
-
28
- ## What if research could be conversational?
29
 
30
  Corvid Council is a multi-agent MCP system that enables dialectic research
31
  through collaborative AI agents. Present a question to the council and watch
32
  as four specialized experts research, debate, and synthesize knowledge—building
33
  on past discussions through shared memory.
34
 
35
- ### Two Modes
36
 
37
- **Collaborative Mode**: Ask a question, receive synthesized research with sources
38
- **Active Mode**: Join the discussion, steer the research direction, challenge claims
39
 
40
- ### The Dialectic Process
41
 
42
- 1. **Thesis**: Characters present initial findings using specialized tools
43
  2. **Antithesis**: Characters challenge, verify, and provide counter-evidence
44
- 3. **Synthesis**: Council builds consensus, adds to collective memory
45
  4. **Evolution**: Future discussions build on accumulated knowledge
46
 
47
  ### Why It Matters
48
 
49
- Most AI assistants are stateless. Corvid Council remembers, learns, and
50
- builds institutional knowledge over time. It's not just answering questions—
51
- it's conducting ongoing research.
 
52
 
53
- - Corvus: 🐦‍⬛ (black bird)
54
- - Magpie: 🪶 (feather, playful)
55
- - Raven: 🦅 (eagle, serious)
56
  - Crow: 🕊️ (dove, peaceful observer)
57
 
58
- **Tagline variations**:
 
 
 
 
59
 
60
- - "A gathering of guides, a council of counsels"
61
- - Alt: "Research that remembers, knowledge that accumulates"
62
- - Technical: "Multi-agent MCP research collective"
63
 
64
- ---
65
 
66
- testing via pytest
67
 
68
- live API calls:
69
- ```uv run --prerelease=allow pytest -q tests/clients```
70
- non-calling tests:
71
- ```uv run --prerelease=allow pytest -q tests/clients/non_calling ```
72
 
 
 
 
73
 
 
 
 
74
 
75
- This project is licensed under the [Apache 2.0 License](LICENSE).
76
 
77
 
78
 
79
- "building-mcp-track-enterprise" for Track 1"
80
- "building-mcp-track-consumer" for Track 1"
81
- "building-mcp-track-creative" for Track 1"
82
 
83
- "mcp-in-action-track-enterprise" for Track 2"
84
- "mcp-in-action-track-consumer" for Track 2"
85
- "mcp-in-action-track-creative" for Track 2"
 
3
  emoji: 💬
4
  colorFrom: yellow
5
  colorTo: purple
6
+ sdk: docker
7
  pinned: false
8
  hf_oauth: true
9
  hf_oauth_scopes:
10
  - inference-api
11
  license: apache-2.0
12
+ short_description: A gathering of guides, a council of counsels
13
  ---
14
 
15
  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).
 
19
 
20
 
21
  # 🐦‍⬛ Cluas
22
+ *A gathering of guides, a council of counsels*
23
 
24
+ > **Clúas** (Gaelic: "ear") a dialectic research tool where AI experts collaborate, remember, and build knowledge over time.
 
25
 
26
+ ## What it Does
 
27
 
28
  Corvid Council is a multi-agent MCP system that enables dialectic research
29
  through collaborative AI agents. Present a question to the council and watch
30
  as four specialized experts research, debate, and synthesize knowledge—building
31
  on past discussions through shared memory.
32
 
33
+ ### Modes
34
 
35
+ - **Collaborative Mode**: Ask a question and receive synthesized research with sources
36
+ - **Active Mode**: Join the discussion, steer research, challenge claims
37
 
38
+ ### Dialectic Process
39
 
40
+ 1. **Thesis**: Characters present initial findings using specialized tools
41
  2. **Antithesis**: Characters challenge, verify, and provide counter-evidence
42
+ 3. **Synthesis**: Council builds consensus and adds to collective memory
43
  4. **Evolution**: Future discussions build on accumulated knowledge
44
 
45
  ### Why It Matters
46
 
47
+ Most AI assistants are stateless. cluas_huginn Council remembers, learns, and builds knowledge over time.
48
+
49
+
50
+ ### Characters
51
 
52
+ - Corvus: 🐦‍⬛ (black bird)
53
+ - Magpie: 🪶 (feather, playful)
54
+ - Raven: 🦅 (eagle, serious)
55
  - Crow: 🕊️ (dove, peaceful observer)
56
 
57
+ ### Taglines
58
+
59
+ - "A gathering of guides, a council of counsels"
60
+ - "Research that remembers, knowledge that accumulates"
61
+ - "Multi-agent MCP research collective"
62
 
 
 
 
63
 
 
64
 
 
65
 
66
+ ## Hackathon Track Entries
 
 
 
67
 
68
+ - "building-mcp-track-enterprise" → Track 1
69
+ - "building-mcp-track-consumer" → Track 1
70
+ - "building-mcp-track-creative" → Track 1
71
 
72
+ - "mcp-in-action-track-enterprise" → Track 2
73
+ - "mcp-in-action-track-consumer" → Track 2
74
+ - "mcp-in-action-track-creative" → Track 2
75
 
 
76
 
77
 
78
 
79
+ ---
 
 
80
 
81
+ This project is licensed under the [Apache 2.0 License](LICENSE).