futurehouse-client 0.3.20.dev55__tar.gz → 0.3.20.dev63__tar.gz

{futurehouse_client-0.3.20.dev55/futurehouse_client.egg-info → futurehouse_client-0.3.20.dev63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: futurehouse-client
-Version: 0.3.20.dev55
+Version: 0.3.20.dev63
 Summary: A client for interacting with endpoints of the FutureHouse service.
 Author-email: FutureHouse technical staff <hello@futurehouse.org>
 License:                                  Apache License
@@ -274,20 +274,19 @@ uv pip install futurehouse-client
 
 ```python
 from futurehouse_client import FutureHouseClient, JobNames
-from pathlib import Path
-from aviary.core import DummyEnv
-import ldp
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+# Set your API key to FUTUREHOUSE_API_KEY environment variable,
+# or pass it as a string literal to the api_key parameter
+client = FutureHouseClient()
 
 task_data = {
     "name": JobNames.CROW,
-    "query": "Which neglected diseases had a treatment developed by artificial intelligence?",
+    "query": (
+        "Which neglected diseases had a treatment developed"
+        " by artificial intelligence?"
+    ),
 }
-
-task_response = client.run_tasks_until_done(task_data)
+(task_response,) = client.run_tasks_until_done(task_data)
 ```
 
 A quickstart example can be found in the [client_notebook.ipynb](https://futurehouse.gitbook.io/futurehouse-cookbook/futurehouse-client/docs/client_notebook) file, where we show how to submit and retrieve a job task, pass runtime configuration to the agent, and ask follow-up questions to the previous job.
@@ -304,9 +303,10 @@ To create a `FutureHouseClient`, you need to pass an FutureHouse platform api ke
 ```python
 from futurehouse_client import FutureHouseClient
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+# Set your API key to FUTUREHOUSE_API_KEY environment variable
+client = FutureHouseClient()
+# Or pass it as a string literal to the api_key parameter
+client = FutureHouseClient(api_key="your_api_key")
 ```
 
 ## Authentication
@@ -333,17 +333,13 @@ Using `JobNames`, the task submission looks like this:
 ```python
 from futurehouse_client import FutureHouseClient, JobNames
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+client = FutureHouseClient()
 
 task_data = {
     "name": JobNames.OWL,
     "query": "Has anyone tested therapeutic exerkines in humans or NHPs?",
 }
-
-task_response = client.run_tasks_until_done(task_data)
-
+(task_response,) = client.run_tasks_until_done(task_data)
 print(task_response.answer)
 ```
 
@@ -363,8 +359,7 @@ async def main():
         "name": JobNames.OWL,
         "query": "Has anyone tested therapeutic exerkines in humans or NHPs?",
     }
-
-    task_response = await client.arun_tasks_until_done(task_data)
+    (task_response,) = await client.arun_tasks_until_done(task_data)
     print(task_response.answer)
     return task_id
 
@@ -382,9 +377,7 @@ from futurehouse_client import FutureHouseClient, JobNames
 
 
 async def main():
-    client = FutureHouseClient(
-        api_key="your_api_key",
-    )
+    client = FutureHouseClient()
 
     task_data = [
         {
@@ -393,10 +386,12 @@ async def main():
         },
         {
             "name": JobNames.CROW,
-            "query": "Are there any clinically validated therapeutic exerkines for humans?",
+            "query": (
+                "Are there any clinically validated"
+                " therapeutic exerkines for humans?"
+            ),
         },
     ]
-
     task_responses = await client.arun_tasks_until_done(task_data)
     print(task_responses[0].answer)
     print(task_responses[1].answer)
@@ -423,17 +418,14 @@ if __name__ == "__main__":
 from futurehouse_client import FutureHouseClient, JobNames
 from futurehouse_client.models.app import TaskRequest
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+client = FutureHouseClient()
 
-task_response = client.run_tasks_until_done(
+(task_response,) = client.run_tasks_until_done(
     TaskRequest(
         name=JobNames.OWL,
         query="Has anyone tested therapeutic exerkines in humans or NHPs?",
     )
 )
-
 print(task_response.answer)
 ```
 
@@ -455,14 +447,13 @@ client = FutureHouseClient(
     api_key="your_api_key",
 )
 
-task_response = client.run_tasks_until_done(
+(task_response,) = client.run_tasks_until_done(
     TaskRequest(
         name=JobNames.OWL,
         query="Has anyone tested therapeutic exerkines in humans or NHPs?",
     ),
     verbose=True,
 )
-
 print(task_response.environment_frame)
 ```
 
@@ -487,17 +478,21 @@ client = FutureHouseClient(
     api_key="your_api_key",
 )
 
-task_data = {"name": JobNames.CROW, "query": "How many species of birds are there?"}
-
+task_data = {
+    "name": JobNames.CROW,
+    "query": "How many species of birds are there?",
+}
 task_id = client.create_task(task_data)
 
 continued_task_data = {
     "name": JobNames.CROW,
-    "query": "From the previous answer, specifically,how many species of crows are there?",
+    "query": (
+        "From the previous answer,"
+        " specifically, how many species of crows are there?"
+    ),
     "runtime_config": {"continued_task_id": task_id},
 }
-
-task_result = client.run_tasks_until_done(continued_task_data)
+(task_response,) = client.run_tasks_until_done(continued_task_data)
 ```
 
 ## Asynchronous tasks
@@ -505,14 +500,14 @@ task_result = client.run_tasks_until_done(continued_task_data)
 Sometimes you may want to submit many jobs, while querying results at a later time. In this way you can do other things while waiting for a response. The platform API supports this as well rather than waiting for a result.
 
 ```python
-from futurehouse_client import FutureHouseClient
-
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+from futurehouse_client import FutureHouseClient, JobNames
 
-task_data = {"name": JobNames.CROW, "query": "How many species of birds are there?"}
+client = FutureHouseClient()
 
+task_data = {
+    "name": JobNames.CROW,
+    "query": "How many species of birds are there?",
+}
 task_id = client.create_task(task_data)
 
 # move on to do other things

{futurehouse_client-0.3.20.dev55 → futurehouse_client-0.3.20.dev63}/README.md

@@ -24,20 +24,19 @@ uv pip install futurehouse-client
 
 ```python
 from futurehouse_client import FutureHouseClient, JobNames
-from pathlib import Path
-from aviary.core import DummyEnv
-import ldp
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+# Set your API key to FUTUREHOUSE_API_KEY environment variable,
+# or pass it as a string literal to the api_key parameter
+client = FutureHouseClient()
 
 task_data = {
     "name": JobNames.CROW,
-    "query": "Which neglected diseases had a treatment developed by artificial intelligence?",
+    "query": (
+        "Which neglected diseases had a treatment developed"
+        " by artificial intelligence?"
+    ),
 }
-
-task_response = client.run_tasks_until_done(task_data)
+(task_response,) = client.run_tasks_until_done(task_data)
 ```
 
 A quickstart example can be found in the [client_notebook.ipynb](https://futurehouse.gitbook.io/futurehouse-cookbook/futurehouse-client/docs/client_notebook) file, where we show how to submit and retrieve a job task, pass runtime configuration to the agent, and ask follow-up questions to the previous job.
@@ -54,9 +53,10 @@ To create a `FutureHouseClient`, you need to pass an FutureHouse platform api ke
 ```python
 from futurehouse_client import FutureHouseClient
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+# Set your API key to FUTUREHOUSE_API_KEY environment variable
+client = FutureHouseClient()
+# Or pass it as a string literal to the api_key parameter
+client = FutureHouseClient(api_key="your_api_key")
 ```
 
 ## Authentication
@@ -83,17 +83,13 @@ Using `JobNames`, the task submission looks like this:
 ```python
 from futurehouse_client import FutureHouseClient, JobNames
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+client = FutureHouseClient()
 
 task_data = {
     "name": JobNames.OWL,
     "query": "Has anyone tested therapeutic exerkines in humans or NHPs?",
 }
-
-task_response = client.run_tasks_until_done(task_data)
-
+(task_response,) = client.run_tasks_until_done(task_data)
 print(task_response.answer)
 ```
 
@@ -113,8 +109,7 @@ async def main():
         "name": JobNames.OWL,
         "query": "Has anyone tested therapeutic exerkines in humans or NHPs?",
     }
-
-    task_response = await client.arun_tasks_until_done(task_data)
+    (task_response,) = await client.arun_tasks_until_done(task_data)
     print(task_response.answer)
     return task_id
 
@@ -132,9 +127,7 @@ from futurehouse_client import FutureHouseClient, JobNames
 
 
 async def main():
-    client = FutureHouseClient(
-        api_key="your_api_key",
-    )
+    client = FutureHouseClient()
 
     task_data = [
         {
@@ -143,10 +136,12 @@ async def main():
         },
         {
             "name": JobNames.CROW,
-            "query": "Are there any clinically validated therapeutic exerkines for humans?",
+            "query": (
+                "Are there any clinically validated"
+                " therapeutic exerkines for humans?"
+            ),
         },
     ]
-
     task_responses = await client.arun_tasks_until_done(task_data)
     print(task_responses[0].answer)
     print(task_responses[1].answer)
@@ -173,17 +168,14 @@ if __name__ == "__main__":
 from futurehouse_client import FutureHouseClient, JobNames
 from futurehouse_client.models.app import TaskRequest
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+client = FutureHouseClient()
 
-task_response = client.run_tasks_until_done(
+(task_response,) = client.run_tasks_until_done(
     TaskRequest(
         name=JobNames.OWL,
         query="Has anyone tested therapeutic exerkines in humans or NHPs?",
     )
 )
-
 print(task_response.answer)
 ```
 
@@ -205,14 +197,13 @@ client = FutureHouseClient(
     api_key="your_api_key",
 )
 
-task_response = client.run_tasks_until_done(
+(task_response,) = client.run_tasks_until_done(
     TaskRequest(
         name=JobNames.OWL,
         query="Has anyone tested therapeutic exerkines in humans or NHPs?",
     ),
     verbose=True,
 )
-
 print(task_response.environment_frame)
 ```
 
@@ -237,17 +228,21 @@ client = FutureHouseClient(
     api_key="your_api_key",
 )
 
-task_data = {"name": JobNames.CROW, "query": "How many species of birds are there?"}
-
+task_data = {
+    "name": JobNames.CROW,
+    "query": "How many species of birds are there?",
+}
 task_id = client.create_task(task_data)
 
 continued_task_data = {
     "name": JobNames.CROW,
-    "query": "From the previous answer, specifically,how many species of crows are there?",
+    "query": (
+        "From the previous answer,"
+        " specifically, how many species of crows are there?"
+    ),
     "runtime_config": {"continued_task_id": task_id},
 }
-
-task_result = client.run_tasks_until_done(continued_task_data)
+(task_response,) = client.run_tasks_until_done(continued_task_data)
 ```
 
 ## Asynchronous tasks
@@ -255,14 +250,14 @@ task_result = client.run_tasks_until_done(continued_task_data)
 Sometimes you may want to submit many jobs, while querying results at a later time. In this way you can do other things while waiting for a response. The platform API supports this as well rather than waiting for a result.
 
 ```python
-from futurehouse_client import FutureHouseClient
-
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+from futurehouse_client import FutureHouseClient, JobNames
 
-task_data = {"name": JobNames.CROW, "query": "How many species of birds are there?"}
+client = FutureHouseClient()
 
+task_data = {
+    "name": JobNames.CROW,
+    "query": "How many species of birds are there?",
+}
 task_id = client.create_task(task_data)
 
 # move on to do other things

{futurehouse_client-0.3.20.dev55 → futurehouse_client-0.3.20.dev63}/futurehouse_client/clients/rest_client.py

@@ -169,7 +169,7 @@ class RestClient:
         self.base_url = service_uri or stage.value
         self.stage = stage
         self.auth_type = auth_type
-        self.api_key = api_key
+        self.api_key = api_key or os.environ.get("FUTUREHOUSE_API_KEY")
         self._clients: dict[str, Client | AsyncClient] = {}
         self.headers = headers or {}
         self.jwt = jwt

{futurehouse_client-0.3.20.dev55 → futurehouse_client-0.3.20.dev63}/futurehouse_client/version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.3.20.dev55'
-__version_tuple__ = version_tuple = (0, 3, 20, 'dev55')
+__version__ = version = '0.3.20.dev63'
+__version_tuple__ = version_tuple = (0, 3, 20, 'dev63')

{futurehouse_client-0.3.20.dev55 → futurehouse_client-0.3.20.dev63/futurehouse_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: futurehouse-client
-Version: 0.3.20.dev55
+Version: 0.3.20.dev63
 Summary: A client for interacting with endpoints of the FutureHouse service.
 Author-email: FutureHouse technical staff <hello@futurehouse.org>
 License:                                  Apache License
@@ -274,20 +274,19 @@ uv pip install futurehouse-client
 
 ```python
 from futurehouse_client import FutureHouseClient, JobNames
-from pathlib import Path
-from aviary.core import DummyEnv
-import ldp
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+# Set your API key to FUTUREHOUSE_API_KEY environment variable,
+# or pass it as a string literal to the api_key parameter
+client = FutureHouseClient()
 
 task_data = {
     "name": JobNames.CROW,
-    "query": "Which neglected diseases had a treatment developed by artificial intelligence?",
+    "query": (
+        "Which neglected diseases had a treatment developed"
+        " by artificial intelligence?"
+    ),
 }
-
-task_response = client.run_tasks_until_done(task_data)
+(task_response,) = client.run_tasks_until_done(task_data)
 ```
 
 A quickstart example can be found in the [client_notebook.ipynb](https://futurehouse.gitbook.io/futurehouse-cookbook/futurehouse-client/docs/client_notebook) file, where we show how to submit and retrieve a job task, pass runtime configuration to the agent, and ask follow-up questions to the previous job.
@@ -304,9 +303,10 @@ To create a `FutureHouseClient`, you need to pass an FutureHouse platform api ke
 ```python
 from futurehouse_client import FutureHouseClient
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+# Set your API key to FUTUREHOUSE_API_KEY environment variable
+client = FutureHouseClient()
+# Or pass it as a string literal to the api_key parameter
+client = FutureHouseClient(api_key="your_api_key")
 ```
 
 ## Authentication
@@ -333,17 +333,13 @@ Using `JobNames`, the task submission looks like this:
 ```python
 from futurehouse_client import FutureHouseClient, JobNames
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+client = FutureHouseClient()
 
 task_data = {
     "name": JobNames.OWL,
     "query": "Has anyone tested therapeutic exerkines in humans or NHPs?",
 }
-
-task_response = client.run_tasks_until_done(task_data)
-
+(task_response,) = client.run_tasks_until_done(task_data)
 print(task_response.answer)
 ```
 
@@ -363,8 +359,7 @@ async def main():
         "name": JobNames.OWL,
         "query": "Has anyone tested therapeutic exerkines in humans or NHPs?",
     }
-
-    task_response = await client.arun_tasks_until_done(task_data)
+    (task_response,) = await client.arun_tasks_until_done(task_data)
     print(task_response.answer)
     return task_id
 
@@ -382,9 +377,7 @@ from futurehouse_client import FutureHouseClient, JobNames
 
 
 async def main():
-    client = FutureHouseClient(
-        api_key="your_api_key",
-    )
+    client = FutureHouseClient()
 
     task_data = [
         {
@@ -393,10 +386,12 @@ async def main():
         },
         {
             "name": JobNames.CROW,
-            "query": "Are there any clinically validated therapeutic exerkines for humans?",
+            "query": (
+                "Are there any clinically validated"
+                " therapeutic exerkines for humans?"
+            ),
         },
     ]
-
     task_responses = await client.arun_tasks_until_done(task_data)
     print(task_responses[0].answer)
     print(task_responses[1].answer)
@@ -423,17 +418,14 @@ if __name__ == "__main__":
 from futurehouse_client import FutureHouseClient, JobNames
 from futurehouse_client.models.app import TaskRequest
 
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+client = FutureHouseClient()
 
-task_response = client.run_tasks_until_done(
+(task_response,) = client.run_tasks_until_done(
     TaskRequest(
         name=JobNames.OWL,
         query="Has anyone tested therapeutic exerkines in humans or NHPs?",
     )
 )
-
 print(task_response.answer)
 ```
 
@@ -455,14 +447,13 @@ client = FutureHouseClient(
     api_key="your_api_key",
 )
 
-task_response = client.run_tasks_until_done(
+(task_response,) = client.run_tasks_until_done(
     TaskRequest(
         name=JobNames.OWL,
         query="Has anyone tested therapeutic exerkines in humans or NHPs?",
     ),
     verbose=True,
 )
-
 print(task_response.environment_frame)
 ```
 
@@ -487,17 +478,21 @@ client = FutureHouseClient(
     api_key="your_api_key",
 )
 
-task_data = {"name": JobNames.CROW, "query": "How many species of birds are there?"}
-
+task_data = {
+    "name": JobNames.CROW,
+    "query": "How many species of birds are there?",
+}
 task_id = client.create_task(task_data)
 
 continued_task_data = {
     "name": JobNames.CROW,
-    "query": "From the previous answer, specifically,how many species of crows are there?",
+    "query": (
+        "From the previous answer,"
+        " specifically, how many species of crows are there?"
+    ),
     "runtime_config": {"continued_task_id": task_id},
 }
-
-task_result = client.run_tasks_until_done(continued_task_data)
+(task_response,) = client.run_tasks_until_done(continued_task_data)
 ```
 
 ## Asynchronous tasks
@@ -505,14 +500,14 @@ task_result = client.run_tasks_until_done(continued_task_data)
 Sometimes you may want to submit many jobs, while querying results at a later time. In this way you can do other things while waiting for a response. The platform API supports this as well rather than waiting for a result.
 
 ```python
-from futurehouse_client import FutureHouseClient
-
-client = FutureHouseClient(
-    api_key="your_api_key",
-)
+from futurehouse_client import FutureHouseClient, JobNames
 
-task_data = {"name": JobNames.CROW, "query": "How many species of birds are there?"}
+client = FutureHouseClient()
 
+task_data = {
+    "name": JobNames.CROW,
+    "query": "How many species of birds are there?",
+}
 task_id = client.create_task(task_data)
 
 # move on to do other things