You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ See our [blog](https://www.futurehouse.org/research-announcements/demonstrating-
6
6
7
7
-**Python:** Version 3.12 or higher.
8
8
-**API Keys:**
9
-
-`EDISON_API_KEY`: For accessing Edison platform agents (Crow, Falcon - now called 'Literature'). Obtain from https://platform.edisonscientific.com/profile. You must first create an Edison profile, purchase credits and then create an API key (Account -> Profile -> API Tokens).
9
+
-`EDISON_API_KEY`: For accessing Edison platform agents (Crow, Falcon - now called 'Literature'). Obtain from https://platform.edisonscientific.com/profile. You must first create an Edison profile, purchase credits and then create an API key (Account -> Profile -> API Tokens).
10
10
- An API key for your chosen LLM provider (e.g., `OPENAI_API_KEY` if using OpenAI models). Robin uses LiteLLM, so it can support various providers.
11
11
- The data analysis portion of this repo requires access to the Edison platform. Without access, all the hypothesis and experiment generation code can still be run.
12
12
@@ -19,15 +19,18 @@ Docker is a tool that packages software into a self-contained "container" that r
19
19
For a fully self-contained environment that avoids OS-level dependency conflicts, Docker is the recommended approach:
20
20
21
21
1.**Build the image:**
22
+
22
23
```bash
23
24
docker build -t robin .
24
25
```
25
26
26
27
2.**Set up API keys:**
28
+
27
29
```bash
28
30
cp .env.example .env
29
31
# Edit .env and fill in your EDISON_API_KEY and OPENAI_API_KEY
30
32
```
33
+
31
34
Important: do **not** wrap values in quotes (e.g. `OPENAI_API_KEY=sk-abc123`, not `OPENAI_API_KEY="sk-abc123"`). Docker reads the file differently from Python and will include the quotes as part of the key.
32
35
33
36
3.**Run Jupyter:**
@@ -159,6 +162,6 @@ These example outputs are provided to help users to understand the depth, format
159
162
160
163
## Advanced Usage
161
164
162
-
A full example trajectory of both the initial therapeutic candidate generation and experimental data analysis can be found in the `robin_full.ipynb` notebook. This notebook includes the parameters and agents used in the paper.
165
+
A full example trajectory of both the initial therapeutic candidate generation and experimental data analysis can be found in the `robin_full.ipynb` notebook. This notebook includes the parameters and agents used in the paper.
163
166
164
167
While this guide focuses on the `robin_demo.ipynb` notebook, the `robin` Python module (in the `robin/` directory) can be imported and its functions (`experimental_assay`, `therapeutic_candidates`, `data_analysis`) can be used programmatically in your own Python scripts for more customized workflows.
0 commit comments