VFB_connect

VFB_connect is a Python lib that wraps data/knowledgeBase query endpoints and returns DataFrame tables.
Available on PyPi:
pip install vfb_connect
Some examples:
# VFB connect object wraps connections and queries to public VFB servers.
from vfb_connect import vfb
# Get TermInfo for Types/Classes, DataSets and anatomical individuals.
vfb.term('FBbt_00003686')
vfb.terms(['Ito02013'])
vfb.terms(['VFB_00010001'])
# Get all terms relevant to a brain region (all parts and all overlapping cells. You can query by label, symbol, synonym, id or xref.
vfb.get_terms_by_region('fan-shaped body')
TermInfo returns a pandas DataFrame by default but can also return a dict summary or full VFBTerms.
For more examples see our Quick Guide Jupyter Notebook
Cached query results
Several queries — similar morphology, the neurons and neuron types in a region, parts, subtypes, lineage clones and innervating tracts — are answered from VFBquery's pre-computed results at https://v3-cached.virtualflybrain.org, the same source the Virtual Fly Brain website reads. Results and column names are unchanged; the query is simply not re-derived. If the service is unavailable, slow or returns an incomplete result, the original Neo4j/Owlery query runs instead, so nothing depends on it being up.
Results larger than one response (25,000 rows) are paged, with a progress bar — a whole
neuropil can be hundreds of thousands of rows. vfb._load_limit truncates them, and any
truncation is reported rather than silent.
vfb.query_counts(id) returns how many results every query on a term would give, in
one request and without running any of them:
vfb.query_counts('FBbt_00003748')
# {'NeuronsSynaptic': 464, 'PartsOf': 28, 'ImagesNeurons': 226524, ...}
A count of -1 there means VFBquery could not count that query — not that it is empty.
Environment variables:
VFB_USE_CACHED_QUERIES=false— always run queries directly.VFB_CACHED_QUERY_URL— point at a different VFBquery deployment.VFB_CACHED_QUERY_MAX_ROWS— row ceiling before a result is truncated (default 250,000).
Methods that use it also take use_cached=True|False to override per call.
Release files for vfb-connect 2.4.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vfb_connect-2.4.3.tar.gz | 49.5 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vfb_connect-2.4.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 58.9 MB
Release files / vfb_connect-2.4.3.tar.gz
| Download URL | vfb_connect-2.4.3.tar.gz |
|---|---|
| Size | 49.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
514103940b1f0b73588167eb138078e3ff22aee27771e316c009df77e6a5c5e2
|
|
BLAKE2b-256 checksum How to use checksums |
2e8097bf99680d9205aa00d882b10d339f85d8e30fec6e618d357b46fbf5e9e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency logRelease files / vfb_connect-2.4.3-py3-none-any.whl
| Download URL | vfb_connect-2.4.3-py3-none-any.whl |
|---|---|
| Size | 9.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a4504287d1f71877613f1fe34140ff20a06efd43319d873ed4b006a2a1cc1ab2
|
|
BLAKE2b-256 checksum How to use checksums |
a6e862c27844bdd38030fd2b5cb9236fb1c9e2675665d41184b1a345d1309ef2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency log