File size: 3,283 Bytes
f2b4e49
 
 
 
 
 
 
 
 
 
 
f632ba8
 
f2b4e49
f632ba8
20ba79b
3fcd8e7
 
 
 
 
 
 
 
f632ba8
 
 
 
 
 
20ba79b
f2b4e49
b4aa4ad
f2b4e49
 
b4aa4ad
f2b4e49
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
f632ba8
f2b4e49
 
 
 
 
 
 
 
f632ba8
f2b4e49
f632ba8
 
 
 
 
 
f2b4e49
 
 
 
 
f632ba8
 
 
f2b4e49
 
 
 
 
3fcd8e7
 
f632ba8
3fcd8e7
f632ba8
f2b4e49
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
# DeepCritical Documentation

## Medical Drug Repurposing Research Agent

AI-powered deep research system for accelerating drug repurposing discovery.

---

## Quick Links

### Architecture
- **[Overview](architecture/overview.md)** - Project overview, use case, architecture
- **[Design Patterns](architecture/design-patterns.md)** - Technical patterns, data models

### Implementation
- **[Roadmap](implementation/roadmap.md)** - Phased execution plan with TDD
- **[Phase 1: Foundation](implementation/01_phase_foundation.md)** βœ… - Tooling, config, first tests
- **[Phase 2: Search](implementation/02_phase_search.md)** βœ… - PubMed search
- **[Phase 3: Judge](implementation/03_phase_judge.md)** βœ… - LLM evidence assessment
- **[Phase 4: UI](implementation/04_phase_ui.md)** βœ… - Orchestrator + Gradio
- **[Phase 5: Magentic](implementation/05_phase_magentic.md)** βœ… - Multi-agent orchestration
- **[Phase 6: Embeddings](implementation/06_phase_embeddings.md)** βœ… - Semantic search + dedup
- **[Phase 7: Hypothesis](implementation/07_phase_hypothesis.md)** βœ… - Mechanistic reasoning
- **[Phase 8: Report](implementation/08_phase_report.md)** βœ… - Structured scientific reports
- **[Phase 9: Source Cleanup](implementation/09_phase_source_cleanup.md)** βœ… - Remove DuckDuckGo
- **[Phase 10: ClinicalTrials](implementation/10_phase_clinicaltrials.md)** βœ… - Clinical trials API
- **[Phase 11: bioRxiv](implementation/11_phase_biorxiv.md)** βœ… - Preprint search
- **[Phase 12: MCP Server](implementation/12_phase_mcp_server.md)** βœ… - Claude Desktop integration
- **[Phase 13: Modal Integration](implementation/13_phase_modal_integration.md)** βœ… - Secure code execution
- **[Phase 14: Demo Submission](implementation/14_phase_demo_submission.md)** βœ… - Hackathon submission

### Guides
- **[Deployment Guide](guides/deployment.md)** - Gradio, MCP, and Modal launch steps

### Development
- **[Testing Strategy](development/testing.md)** - Unit, Integration, and E2E testing patterns

---

## What We're Building

**One-liner**: AI agent that searches medical literature to find existing drugs that might treat new diseases.

**Example Query**:
> "What existing drugs might help treat long COVID fatigue?"

**Output**: Research report with drug candidates, mechanisms, evidence quality, and citations.

---

## Architecture Summary

```
User Question β†’ Research Agent (Orchestrator)
                      ↓
              Search Loop:
                β†’ Tools (PubMed, ClinicalTrials, bioRxiv)
                β†’ Judge (Quality + Budget)
                β†’ Repeat or Synthesize
                      ↓
              Research Report with Citations
```

---

## Features

| Feature | Status | Description |
|---------|--------|-------------|
| **Gradio UI** | βœ… Complete | Streaming chat interface |
| **MCP Server** | βœ… Complete | Tools accessible from Claude Desktop |
| **Modal Sandbox** | βœ… Complete | Secure statistical analysis |
| **Multi-Source Search** | βœ… Complete | PubMed, ClinicalTrials, bioRxiv |

---

## Team

- The-Obstacle-Is-The-Way
- MarioAderman
- Josephrp

---

## Status

| Phase | Status |
|-------|--------|
| Phases 1-14 | βœ… COMPLETE |

**Test Coverage**: 65% (96 tests passing)
**Architecture Review**: PASSED (98-99/100)