Skip to main content

anatomyfyi

PyPI version Python License: MIT Zero Dependencies

Python API client for human anatomy data. Look up 14,692 anatomical structures across 12 body systems, explore organ relationships, trace nerve pathways, and query muscle attachments — all from AnatomyFYI, a comprehensive anatomical reference covering systems from the skeletal framework to the nervous system.

Built on the AnatomyFYI database of 14,692 structures with Terminologia Anatomica identifiers, hierarchical parent-child relationships, and cross-system associations used by medical students, anatomists, and health-tech developers worldwide.

Explore the interactive anatomy reference at anatomyfyi.com — browse by body system, search structures, and explore organ relationships.

anatomyfyi demo — human anatomy lookup, body systems, and organ relationships in Python

Table of Contents

Install

pip install anatomyfyi                # Core (zero deps)
pip install "anatomyfyi[cli]"         # + Command-line interface
pip install "anatomyfyi[mcp]"         # + MCP server for AI assistants
pip install "anatomyfyi[api]"         # + HTTP client for anatomyfyi.com API
pip install "anatomyfyi[all]"         # Everything

Quick Start

from anatomyfyi.api import AnatomyFYI

with AnatomyFYI() as api:
    # List all body systems (skeletal, muscular, nervous, etc.)
    systems = api.list_systems()
    for system in systems:
        print(f"{system['name']}: {system['structure_count']} structures")

    # Get detailed info on a specific structure
    heart = api.get_structure("heart")
    print(heart["name"])         # Heart
    print(heart["system"])       # Cardiovascular System
    print(heart["latin_name"])   # Cor

    # Search across all anatomical structures
    results = api.search("femoral")
    for r in results:
        print(f"{r['name']} ({r['system']})")

What You Can Do

Body Systems

The human body is organized into 12 major organ systems, each performing distinct physiological functions. AnatomyFYI catalogs structures within every system, from the 206 bones of the skeletal system to the complex neural networks of the nervous system.

System Key Structures Focus
Skeletal Bones, joints, cartilage 206 bones, axial vs appendicular
Muscular Skeletal, smooth, cardiac muscle 600+ muscles, origins & insertions
Nervous Brain, spinal cord, nerves Central & peripheral nervous system
Cardiovascular Heart, arteries, veins Blood circulation, cardiac cycle
Respiratory Lungs, bronchi, alveoli Gas exchange, breathing mechanics
Digestive Stomach, intestines, liver Nutrient absorption, GI tract
Endocrine Glands, hormones Pituitary, thyroid, adrenal regulation
Lymphatic Lymph nodes, spleen, thymus Immune defense, fluid balance
Urinary Kidneys, bladder, ureters Filtration, waste elimination
Reproductive Gonads, uterus, accessory organs Male and female systems
Integumentary Skin, hair, nails Protection, thermoregulation
Special Senses Eyes, ears, nose Vision, hearing, olfaction
from anatomyfyi.api import AnatomyFYI

with AnatomyFYI() as api:
    # Browse all body systems
    systems = api.list_systems()
    for s in systems:
        print(f"{s['name']}: {s['structure_count']} structures")

    # Get all structures in the nervous system
    nervous = api.get_system("nervous")
    print(nervous["description"])

Learn more: Body Systems · Glossary

Structure Lookup

Each of the 14,692 structures in the database includes its Terminologia Anatomica name (the international standard for anatomical nomenclature), Latin equivalent, parent system, and hierarchical position within the body.

from anatomyfyi.api import AnatomyFYI

with AnatomyFYI() as api:
    # Detailed structure lookup with Latin name and hierarchy
    femur = api.get_structure("femur")
    print(femur["name"])         # Femur
    print(femur["latin_name"])   # Os femoris
    print(femur["system"])       # Skeletal System
    print(femur["region"])       # Lower Limb

Learn more: Anatomical Structures · Guides

Organ Relationships

Anatomy is fundamentally about relationships — how structures connect, supply, innervate, and depend on each other. The cardiovascular system supplies every organ, the nervous system innervates every muscle, and the lymphatic system drains every tissue.

from anatomyfyi.api import AnatomyFYI

with AnatomyFYI() as api:
    # Explore relationships of a structure
    heart = api.get_structure("heart")
    print(heart["blood_supply"])   # Coronary arteries
    print(heart["innervation"])    # Cardiac plexus

Learn more: Organ Relationships · Glossary

Anatomical Planes and Directions

All anatomical descriptions reference the anatomical position (standing upright, palms forward) and use three cardinal planes — sagittal (left/right), coronal (front/back), and transverse (upper/lower). Directional terms like anterior/posterior, medial/lateral, and proximal/distal provide unambiguous spatial references.

Plane Division Clinical Use
Sagittal Left / Right MRI brain scans
Coronal Anterior / Posterior Chest X-rays
Transverse Superior / Inferior CT cross-sections
from anatomyfyi.api import AnatomyFYI

with AnatomyFYI() as api:
    # Search for structures by anatomical region
    results = api.search("anterior")
    for r in results[:5]:
        print(f"{r['name']} — {r['system']}")

Learn more: Anatomical Terminology · API Documentation

Command-Line Interface

pip install "anatomyfyi[cli]"

anatomyfyi systems                        # List all body systems
anatomyfyi structure heart                 # Structure details
anatomyfyi search "femoral artery"         # Search structures
anatomyfyi system nervous                  # All nervous system structures

MCP Server (Claude, Cursor, Windsurf)

pip install "anatomyfyi[mcp]"
{
    "mcpServers": {
        "anatomyfyi": {
            "command": "uvx",
            "args": ["--from", "anatomyfyi[mcp]", "python", "-m", "anatomyfyi.mcp_server"]
        }
    }
}

REST API Client

from anatomyfyi.api import AnatomyFYI

with AnatomyFYI() as api:
    systems = api.list_systems()               # GET /api/v1/systems/
    structure = api.get_structure("heart")      # GET /api/v1/structures/heart/
    results = api.search("brachial")           # GET /api/v1/search/?q=brachial

Example

curl -s "https://anatomyfyi.com/api/v1/structures/heart/"
{
    "slug": "heart",
    "name": "Heart",
    "latin_name": "Cor",
    "system": "Cardiovascular System",
    "region": "Thorax"
}

Full API documentation at anatomyfyi.com/developers/.

API Reference

Function Description
api.list_systems() List all 12 body systems
api.get_system(slug) System details with structure list
api.list_structures() List all 14,692 structures
api.get_structure(slug) Structure detail (system, region, Latin name)
api.search(query) Search across all structures

Learn More About Anatomy

Also Available

Platform Install Link
npm npm install anatomyfyi npm
MCP uvx --from "anatomyfyi[mcp]" python -m anatomyfyi.mcp_server Config

Health FYI Family

Part of the FYIPedia open-source developer tools ecosystem — human body, medicine, and nutrition.

Package PyPI npm Description
anatomyfyi PyPI npm 14,692 anatomical structures, body systems, organs — anatomyfyi.com
pillfyi PyPI npm Pill identification, FDA drug database — pillfyi.com
drugfyi PyPI npm Drug interactions, pharmacology, side effects — drugfyi.com
nutrifyi PyPI npm Nutrition data, food composition, dietary analysis — nutrifyi.com

License

MIT

Metadata

Release files for anatomyfyi 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for anatomyfyi 0.1.1
File Size Uploaded
anatomyfyi-0.1.1.tar.gz 618.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for anatomyfyi 0.1.1
File Interpreter ABI Platform
anatomyfyi-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 627.5 kB

Release files / anatomyfyi-0.1.1.tar.gz

Download URL anatomyfyi-0.1.1.tar.gz
Size 618.7 kB
Tags Source
SHA-256 checksum
How to use checksums
93f69ceed3d7666826ae8646e12be19d785c465c4d5bcbcb11f7b7dcdd57182e
BLAKE2b-256 checksum
How to use checksums
478cf4c7063cc83e342436729c36705769ef78fa0c81936e33e93aa7af7ef7d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / anatomyfyi-0.1.1-py3-none-any.whl

Download URL anatomyfyi-0.1.1-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0a7c2b2530c7ca3ae9d945dce21e9740ecf014e7b306e5e78970937705af14bf
BLAKE2b-256 checksum
How to use checksums
af71f89ad252cc611dce2431d900a5bc366bffdfeff93206953bc10bb8dfa9a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.11 {"installer":{"name":"uv","version":"0.10.11","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page