Hugging Face's logo

Spaces:
VibecoderMcSwaggins
/
DeepBoner
Paused

App Files Community
VibecoderMcSwaggins commited on
Commit
d8b1415
·
1 Parent(s): 4d7d84f

docs: Update architecture docs with current state

Browse files

- Fix ARCHITECTURE.md: 72B→7B, Free Tier now WORKING (not blocked)
- Add Key Fixes Applied section documenting all major bug fixes
- Update test count: 142→318 (accurate count)
- Archive resolved bug docs: P1_FREE_TIER, P2_7B_MODEL

Files changed (4) hide show
  1. docs/ARCHITECTURE.md +17 -18
  2. docs/bugs/{P1_FREE_TIER_TOOL_EXECUTION_FAILURE.md → archive/P1_FREE_TIER_TOOL_EXECUTION_FAILURE.md} +0 -0
  3. docs/bugs/{P2_7B_MODEL_GARBAGE_OUTPUT.md → archive/P2_7B_MODEL_GARBAGE_OUTPUT.md} +0 -0
  4. docs/index.md +1 -1
docs/ARCHITECTURE.md CHANGED
@@ -1,6 +1,6 @@
1
  # DeepBoner Architecture
2
 
3
- > **Last Updated**: 2025-12-01
4
 
5
  ---
6
 
@@ -15,7 +15,7 @@
15
  │ NO (Free Tier) YES (Paid Tier) │
16
  │ ────────────── ─────────────── │
17
  │ HuggingFace backend OpenAI backend │
18
- │ Qwen 2.5 72B (free) GPT-5 (paid) │
19
  │ │
20
  │ SAME orchestration logic for both │
21
  │ ONE codebase, different LLM backends │
@@ -28,12 +28,21 @@
28
 
29
  ## Current Status
30
 
31
- **Free Tier is BLOCKED** by upstream bug #2562.
32
 
33
- Once [PR #2566](https://github.com/microsoft/agent-framework/pull/2566) merges:
34
- 1. Update `agent-framework` dependency
35
- 2. Free tier works
36
- 3. Done
 
 
 
 
 
 
 
 
 
37
 
38
  ---
39
 
@@ -65,7 +74,7 @@ def get_chat_client():
65
  | Condition | Backend | Model |
66
  |-----------|---------|-------|
67
  | User provides OpenAI key | OpenAI | GPT-5 |
68
- | No API key provided | HuggingFace | Qwen 2.5 72B (free) |
69
 
70
  ---
71
 
@@ -87,16 +96,6 @@ def get_chat_client():
87
 
88
  ---
89
 
90
- ## Upstream Blocker
91
-
92
- **Bug:** Microsoft Agent Framework produces `repr()` garbage for tool-call-only messages.
93
-
94
- **Fix:** [PR #2566](https://github.com/microsoft/agent-framework/pull/2566) - waiting to merge.
95
-
96
- **Tracking:** [Issue #2562](https://github.com/microsoft/agent-framework/issues/2562)
97
-
98
- ---
99
-
100
  ## References
101
 
102
  - [Pydantic AI](https://ai.pydantic.dev/) - Structured outputs framework
 
1
  # DeepBoner Architecture
2
 
3
+ > **Last Updated**: 2025-12-03
4
 
5
  ---
6
 
 
15
  │ NO (Free Tier) YES (Paid Tier) │
16
  │ ────────────── ─────────────── │
17
  │ HuggingFace backend OpenAI backend │
18
+ │ Qwen 2.5 7B (free) GPT-5 (paid) │
19
  │ │
20
  │ SAME orchestration logic for both │
21
  │ ONE codebase, different LLM backends │
 
28
 
29
  ## Current Status
30
 
31
+ **Both tiers are WORKING** as of December 2025.
32
 
33
+ - **Free Tier**: Uses Accumulator Pattern to bypass upstream repr bug
34
+ - **Paid Tier**: Full OpenAI GPT-5 integration
35
+
36
+ ---
37
+
38
+ ## Key Fixes Applied
39
+
40
+ | Issue | Fix | PR |
41
+ |-------|-----|-----|
42
+ | Tool execution failure | Removed premature `__function_invoking_chat_client__` marker | fix/P1-free-tier |
43
+ | Repr garbage in output | Accumulator Pattern bypasses upstream bug | PR #117 |
44
+ | 72B model routing failures | Switched to 7B (native HF infra) | PR #118 |
45
+ | Evidence deduplication | Cross-source dedup by PMID/DOI | PR #122 |
46
 
47
  ---
48
 
 
74
  | Condition | Backend | Model |
75
  |-----------|---------|-------|
76
  | User provides OpenAI key | OpenAI | GPT-5 |
77
+ | No API key provided | HuggingFace | Qwen 2.5 7B (free) |
78
 
79
  ---
80
 
 
96
 
97
  ---
98
 
 
 
 
 
 
 
 
 
 
 
99
  ## References
100
 
101
  - [Pydantic AI](https://ai.pydantic.dev/) - Structured outputs framework
docs/bugs/{P1_FREE_TIER_TOOL_EXECUTION_FAILURE.md → archive/P1_FREE_TIER_TOOL_EXECUTION_FAILURE.md} RENAMED
File without changes
docs/bugs/{P2_7B_MODEL_GARBAGE_OUTPUT.md → archive/P2_7B_MODEL_GARBAGE_OUTPUT.md} RENAMED
File without changes
docs/index.md CHANGED
@@ -103,5 +103,5 @@ User Question → Research Agent (Orchestrator)
103
  |-------|--------|
104
  | Phases 1-14 | ✅ COMPLETE |
105
 
106
- **Tests**: 142+ passing, 0 warnings
107
  **Known Issues**: See [Active Bugs](bugs/ACTIVE_BUGS.md)
 
103
  |-------|--------|
104
  | Phases 1-14 | ✅ COMPLETE |
105
 
106
+ **Tests**: 318 passing, 0 warnings
107
  **Known Issues**: See [Active Bugs](bugs/ACTIVE_BUGS.md)