Python Scientific OS
FastAPI backend equivalent of the TypeScript scientific OS server.
Setup
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env
Add OPENAI_API_KEY and optionally TAVILY_API_KEY to .env.
By default, local development uses SQLite and local file storage, so Docker is optional.
For the full optional stack, install extras:
pip install -e ".[all]"
Package Usage
Install the package in editable mode while developing:
pip install -e .
Install optional Postgres/MinIO support:
pip install -e ".[postgres,s3]"
Build a wheel:
python -m pip wheel . --no-deps -w dist
Install the built wheel:
pip install dist/python_scientific_os-0.1.0-py3-none-any.whl
Start the server
Start the FastAPI server from the project root:
scientific-os-server --reload --port 8000
The API will be available at http://127.0.0.1:8000.
You can also run the app directly with Uvicorn:
uvicorn scientific_os.main:app --reload --port 8000
CLI Chat
With the server running, send a prompt from another terminal:
scientific-os "Create a simple protocol for extracting strawberry DNA."
The CLI prints the response and writes returned IDs, including conversationId and jobId, to stderr.
Use that ID to continue the same conversation:
scientific-os \
--conversation-id 00000000-0000-0000-0000-000000000000 \
"Make it safer for a classroom demo."
Replace the placeholder UUID with the real conversationId.
You can also pipe prompt text into the CLI:
echo "Create a protocol for testing soil pH." | scientific-os
Use --pretty to print the full JSON response:
scientific-os --pretty "List the protocol sections you generated."
Each chat request is tracked as a job. List recent jobs:
scientific-os --list-jobs
Fetch a single job:
scientific-os --job-id 00000000-0000-0000-0000-000000000000
Filter jobs by status:
scientific-os --list-jobs --status failed
If the server is running somewhere else, pass a custom base URL:
scientific-os --server http://127.0.0.1:8001 "Hello"
Without installing the package, the CLI still works as a module:
python -m scientific_os.cli "Hello"
HTTP Chat
Send a chat request to the local server:
curl -sS http://127.0.0.1:8000/api/chat \
-H "Content-Type: application/json" \
-d '{
"messages": [
{
"role": "user",
"content": "Create a simple protocol for extracting strawberry DNA."
}
]
}'
To continue a conversation, include the conversationId returned by the previous response:
curl -sS http://127.0.0.1:8000/api/chat \
-H "Content-Type: application/json" \
-d '{
"conversationId": "00000000-0000-0000-0000-000000000000",
"messages": [
{
"role": "user",
"content": "Make it safer for a classroom demo."
}
]
}'
Replace the placeholder UUID with the real conversationId.
Chat and protocol search requests are tracked as jobs. List recent jobs over HTTP:
curl -sS http://127.0.0.1:8000/api/jobs
Fetch a single job:
curl -sS http://127.0.0.1:8000/api/jobs/00000000-0000-0000-0000-000000000000
Optional Docker Services
To use Postgres/pgvector and MinIO instead, set these values in .env:
DATABASE_URL=postgresql://myuser:mypassword@localhost:5432/mydb
STORAGE_BACKEND=s3
S3_ENDPOINT=http://localhost:9000
S3_PUBLIC_ENDPOINT=http://localhost:9000
Then start the backing services with docker compose up -d.
The compatible API routes are:
POST /api/chatGET /api/jobsGET /api/jobs/{job_id}GET /api/conversationsGET /api/conversations/{conversation_id}GET /api/protocols/searchGET /api/protocols/{protocol_id}
Metadata
Release files for python-scientific-os 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| python_scientific_os-0.1.0.tar.gz | 19.9 kB | Without provenance | Details for python_scientific_os-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| python_scientific_os-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for python_scientific_os-0.1.0-py3-none-any.whl |
Total release size: 42.5 kB
Release files / python_scientific_os-0.1.0.tar.gz
| Download URL | python_scientific_os-0.1.0.tar.gz |
|---|---|
| Size | 19.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0a7e535e71ddb49e6e34f2bb6e6092b1f248ada99cb147eed24c7e81e5c5f029
|
|
BLAKE2b-256 checksum How to use checksums |
d682dc975b19a732aafcac2eceadabb32b29b1b94cd7a36e3bdc817e08b138da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Release files / python_scientific_os-0.1.0-py3-none-any.whl
| Download URL | python_scientific_os-0.1.0-py3-none-any.whl |
|---|---|
| Size | 22.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bdadd797cea07c5e3b107edca02a08a230e7a99cf6aea35a3416097ea00d053b
|
|
BLAKE2b-256 checksum How to use checksums |
ee0b49ed6fcde8ff208437dd252fd492ccd0faaa79937d5c1c7a03871aa808b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.3
|
Security for python-scientific-os 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.