mara client module
This package provides a Python interface for the MARA conversational agent for cheminformatics.
Installation
pip install mara-client
Usage
To use the MARA client, you need to have an API key. You can create one at https://app.nanome.ai/settings/api-keys.
MARA chats are created using the new_chat method, or retrieved with the get_chat method of the client. You can then interact with the chat using the prompt method. The prompt method returns a ChatResult object, which contains the response from MARA, intermediate messages such as tool runs, and any files that were generated during the conversation. You can download these files using the download_file method of the chat. Chat will be visible as conversations in the MARA web interface, and can be deleted using the delete method.
from mara_client import MARAClient
API_KEY = "..."
URL = "https://nanome.example.com" # optional
client = MARAClient(API_KEY, URL)
chat = client.new_chat()
# or, chat = client.get_chat("chat_id")
result = chat.prompt('Download SDF of aspirin')
print(result.response)
# The SDF file for the compound aspirin has been downloaded successfully. You can access it [here](CHEMBL25.sdf).
print(result.files)
# [ChatFile(id='...', name='CHEMBL25.sdf', size=1203, date=...)]
chat.files.download('CHEMBL25.sdf', 'aspirin.sdf')
# downloaded as aspirin.sdf in current working directory
result = chat.prompt('Calculate chem props')
print(result.response)
# The chemical properties of the compound with ChEMBL ID CHEMBL25 (aspirin) are as follows:
#
# | Property | Value |
# | --- | --- |
# | Molecular Weight (MW) | 180.159 |
# | LogP | 1.310 |
# | Total Polar Surface Area (TPSA) | 63.600 |
# | Hydrogen Bond Acceptors (HBA) | 3 |
# | Hydrogen Bond Donors (HBD) | 1 |
# | Rotatable Bonds (RB) | 2 |
chat.delete()
# remove chat from history, delete associated files and data
Files
The chat object contains a files attribute for working with files.
# Upload a file as part of a prompt
file_path = './example.sdf'
result = chat.prompt('Convert this to SMILES', files=[file_path])
# List all files
file_list = chat.files.list()
# Download a file
file_name = file_list[0].name
chat.files.download(file_name, 'output.sdf')
# Upload a file directly
file_path = './example.sdf'
file = chat.files.upload(file_path)
print(file.id)
Data Tables
The chat object contains a datatables attribute for working with DataTables.
# Create a data table from already uploaded file
csv_file = './example.csv'
datatable: DataTable = chat.datatables.create(csv_file)
# List all data tables
table_list = chat.datatables.list()
# Generate a new DataTable based on Chat context
chat.datatables.generate()
# Run prompt to update/query a datatable
dt_id = datatable.id
chat.datatables.prompt(dt_id, prompt)
# Retrieve a datatable
chat.datatables.get(dt_id)
# View datatable as a pandas Dataframe
df = datatable.dataframe
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mara_client-1.1.0.tar.gz.
File metadata
- Download URL: mara_client-1.1.0.tar.gz
- Upload date:
- Size: 5.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
84a70e89b92a71ae65d2758fdfc1283967e42f44ee27d31cf7297a64b1130634
|
|
| MD5 |
05b4d6c93ede604808b0fd72e6a33221
|
|
| BLAKE2b-256 |
47cdd83f7e37305c14d2b47e57d6832e8c02e54bdc50bed3b77ec635aed30b69
|
File details
Details for the file mara_client-1.1.0-py3-none-any.whl.
File metadata
- Download URL: mara_client-1.1.0-py3-none-any.whl
- Upload date:
- Size: 6.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b91c7ebe2f99c9dd04ecdb441d763c9b7aca2eb7722b1e6a1ad9be44c20557e4
|
|
| MD5 |
8a1a8e82ea5b2582d202403282610c5e
|
|
| BLAKE2b-256 |
91bba1bfb88bbaaf4550e24776d0b2b97bc4071854abdeafb7149cffacbcecf4
|
