imamiland/aaprop repository overview

⁠AAProp — Amino Acid Properties API

AAProp is a lightweight REST service that provides essential biochemical properties for the 20 standard amino acids.

⁠🚀 Features

• Query by amino acid name, three-letter code, or one-letter code
• Returns structured JSON with:
  • Full name (e.g., “Alanine”)
  • Short name / three-letter code (e.g., “Ala”)
  • One-letter code (e.g., “A”)
  • Side-chain classification (e.g., “Nonpolar”)
  • Molecular weight (e.g., 89.09)
  • List of codons (e.g., ["GCT", "GCC", "GCA", "GCG"])
• Fast, minimal, and suitable for integration in bioinformatics pipelines or microservices

⁠🌐 Live API

The public endpoint is available at: https://aaprop.shuttleapp.rs⁠

To fetch data for “Alanine”, for example:

curl https://aaprop.shuttleapp.rs/amino_acid/Alanine

Sample response:

{
  "amino_acid": {
    "name": "Alanine",
    "short_name": "Ala",
    "abbreviation": "A",
    "side_chain": "Nonpolar",
    "molecular_weight": 89.09,
    "codons": ["GCT", "GCC", "GCA", "GCG"]
  }
}

⁠📦 Running via Docker

To run your own instance of AAProp using Docker:

docker pull imamiland/aaprop:latest docker run -p 8000:8000 aaprop:latest

Once running, you can query the API at:

http://localhost:8000/amino_acid/{identifier}⁠

where {identifier} is the amino acid name, three-letter code, or one-letter code.

⁠🔗 Useful Links

• Source Code: GitHub repository⁠

• Live Demo / Quick Start: AAProp Quick Start Guide⁠

• License: MIT OR Apache-2.0

⁠Use Cases

• Bioinformatics tools and pipelines that need accurate amino-acid metadata

• Web services or microservices architecture to avoid hard-coding amino acid constants

• Teaching or research projects where easy, programmatic access to amino-acid properties is helpful