{"id":13703339,"url":"https://github.com/biopython/biopython","last_synced_at":"2025-05-13T11:02:06.789Z","repository":{"id":523108,"uuid":"151541","full_name":"biopython/biopython","owner":"biopython","description":"Official git repository for Biopython (originally converted from CVS)","archived":false,"fork":false,"pushed_at":"2025-04-07T18:42:57.000Z","size":74988,"stargazers_count":4580,"open_issues_count":544,"forks_count":1786,"subscribers_count":163,"default_branch":"master","last_synced_at":"2025-05-05T20:49:42.861Z","etag":null,"topics":["bioinformatics","biopython","dna","genomics","phylogenetics","protein","protein-structure","python","sequence-alignment"],"latest_commit_sha":null,"homepage":"http://biopython.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/biopython.png","metadata":{"files":{"readme":"README.rst","changelog":"NEWS.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2009-03-15T21:09:53.000Z","updated_at":"2025-05-05T08:26:42.000Z","dependencies_parsed_at":"2024-09-17T12:31:04.722Z","dependency_job_id":"1517707a-4828-4e7e-8350-58dde4fab8a5","html_url":"https://github.com/biopython/biopython","commit_stats":{"total_commits":15524,"total_committers":483,"mean_commits":32.1407867494824,"dds":0.6129863437258438,"last_synced_commit":"4fc5158970b7970907fb932eae15eb779fdea839"},"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biopython%2Fbiopython","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biopython%2Fbiopython/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biopython%2Fbiopython/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biopython%2Fbiopython/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/biopython","download_url":"https://codeload.github.com/biopython/biopython/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253518941,"owners_count":21921074,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioinformatics","biopython","dna","genomics","phylogenetics","protein","protein-structure","python","sequence-alignment"],"created_at":"2024-08-02T21:00:53.592Z","updated_at":"2025-05-13T11:02:06.720Z","avatar_url":"https://github.com/biopython.png","language":"Python","readme":".. image:: https://img.shields.io/pypi/v/biopython.svg?logo=pypi\n   :alt: Biopython on the Python Package Index (PyPI)\n   :target: https://pypi.python.org/pypi/biopython\n.. image:: https://img.shields.io/conda/vn/conda-forge/biopython.svg?logo=conda-forge\n   :alt: Biopython on the Conda package conda-forge channel\n   :target: https://anaconda.org/conda-forge/biopython\n.. image:: https://results.pre-commit.ci/badge/github/biopython/biopython/master.svg\n   :target: https://results.pre-commit.ci/latest/github/biopython/biopython/master\n   :alt: pre-commit.ci status\n.. image:: https://img.shields.io/circleci/build/github/biopython/biopython.svg?logo=circleci\n   :alt: Linux testing with CircleCI\n   :target: https://app.circleci.com/pipelines/github/biopython/biopython\n.. image:: https://img.shields.io/appveyor/ci/biopython/biopython/master.svg?logo=appveyor\n   :alt: Windows testing with AppVeyor\n   :target: https://ci.appveyor.com/project/biopython/biopython/history\n.. image:: https://img.shields.io/github/actions/workflow/status/biopython/biopython/ci.yml?logo=github-actions\n   :alt: GitHub workflow status\n   :target: https://github.com/biopython/biopython/actions\n.. image:: https://img.shields.io/codecov/c/github/biopython/biopython/master.svg?logo=codecov\n   :alt: Test coverage on CodeCov\n   :target: https://codecov.io/github/biopython/biopython/\n.. image:: http://depsy.org/api/package/pypi/biopython/badge.svg\n   :alt: Research software impact on Depsy\n   :target: http://depsy.org/package/python/biopython\n\n.. image:: https://github.com/biopython/biopython/raw/master/Doc/images/biopython_logo_m.png\n   :alt: The Biopython Project\n   :target: http://biopython.org\n\nBiopython README file\n=====================\n\nThe Biopython Project is an international association of developers of freely\navailable Python tools for computational molecular biology.\n\nThis README file is intended primarily for people interested in working\nwith the Biopython source code, either one of the releases from the\nhttp://biopython.org website, or from our repository on GitHub\nhttps://github.com/biopython/biopython\n\nOur user-centric documentation, `The Biopython Tutorial and Cookbook, and API\ndocumentation \u003chttps://biopython.org/docs/latest/\u003e`_, is generated from our\nrepository using Sphinx.\n\nThe `NEWS \u003chttps://github.com/biopython/biopython/blob/master/NEWS.rst\u003e`_\nfile summarises the changes in each release of Biopython, alongside the\n`DEPRECATED\n\u003chttps://github.com/biopython/biopython/blob/master/DEPRECATED.rst\u003e`_\nfile which notes API breakages.\n\nThe Biopython package is open source software made available under generous\nterms. Please see the `LICENSE\n\u003chttps://github.com/biopython/biopython/blob/master/LICENSE.rst\u003e`_ file for\nfurther details.\n\nIf you use Biopython in work contributing to a scientific publication, we ask\nthat you cite our application note (below) or one of the module specific\npublications (listed on our website):\n\nCock, P.J.A. et al. Biopython: freely available Python tools for computational\nmolecular biology and bioinformatics. Bioinformatics 2009 Jun 1; 25(11) 1422-3\nhttps://doi.org/10.1093/bioinformatics/btp163 pmid:19304878\n\n\nFor the impatient\n=================\n\nPython includes the package management system \"pip\" which should allow you to\ninstall Biopython (and its dependency NumPy if needed), upgrade or uninstall\nwith just one terminal command::\n\n    pip install biopython\n    pip install --upgrade biopython\n    pip uninstall biopython\n\nSince Biopython 1.70 we have provided pre-compiled binary wheel packages on\nPyPI for Linux, macOS and Windows. This means pip install should be quick,\nand not require a compiler.\n\nAs a developer or potential contributor, you may wish to download, build and\ninstall Biopython yourself. This is described below.\n\n\nPython Requirements\n===================\n\nWe currently recommend using Python 3.11 from http://www.python.org\n\nBiopython is currently supported and tested on the following Python\nimplementations:\n\n- Python 3.10, 3.11, 3.12 and 3.13 -- see http://www.python.org\n\n- PyPy3.10 v7.3.17 -- or later, see http://www.pypy.org\n\n\nOptional Dependencies\n=====================\n\nBiopython requires NumPy (see http://www.numpy.org) which will be installed\nautomatically if you install Biopython with pip (see below for compiling\nBiopython yourself).\n\nDepending on which parts of Biopython you plan to use, there are a number of\nother optional Python dependencies, which can be installed later if needed:\n\n- ReportLab, see http://www.reportlab.com/opensource/ (optional)\n  This package is only used in ``Bio.Graphics``, so if you do not need this\n  functionality, you will not need to install this package.\n\n- matplotlib, see http://matplotlib.org/ (optional)\n  ``Bio.Phylo`` uses this package to plot phylogenetic trees.\n\n- networkx, see https://networkx.github.io/ (optional) and\n  pygraphviz or pydot, see https://pygraphviz.github.io/ and\n  http://code.google.com/p/pydot/ (optional)\n  These packages are used for certain niche functions in ``Bio.Phylo``.\n\n- rdflib, see https://github.com/RDFLib/rdflib (optional)\n  This package is used in the CDAO parser under ``Bio.Phylo``.\n\n- psycopg2, see http://initd.org/psycopg/ (optional) or\n  PyGreSQL (pgdb), see http://www.pygresql.org/ (optional)\n  These packages are used by ``BioSQL`` to access a PostgreSQL database.\n\n- MySQL Connector/Python, see http://dev.mysql.com/downloads/connector/python/\n  This package is used by ``BioSQL`` to access a MySQL database, and is\n  supported on PyPy too.\n\n- mysqlclient, see https://github.com/PyMySQL/mysqlclient-python (optional)\n  This is a fork of the older MySQLdb and is used by ``BioSQL`` to access a\n  MySQL database. It is supported by PyPy.\n\nIn addition there are a number of useful third party tools you may wish to\ninstall such as standalone NCBI BLAST, EMBOSS or ClustalW.\n\n\nInstallation From Source\n========================\n\nWe recommend using the pre-compiled binary wheels available on PyPI using::\n\n    pip install biopython\n\nHowever, if you need to compile Biopython yourself, the following are required\nat compile time:\n\n- Python including development header files like ``python.h``, which on Linux\n  are often not installed by default (trying looking for and installing a\n  package named ``python-dev`` or ``python-devel`` as well as the ``python``\n  package).\n\n- Appropriate C compiler for your version of Python, for example GCC on Linux,\n  MSVC on Windows. For Mac OS X, or as it is now branded, macOS, use Apple's\n  command line tools, which can be installed with the terminal command::\n\n      xcode-select --install\n\n  This will offer to install Apple's XCode development suite - you can, but it\n  is not needed and takes a lot of disk space.\n\nThen either download and decompress our source code, or fetch it using git.\nNow change directory to the Biopython source code folder and run::\n\n    pip install -e .\n    python setup.py test\n    sudo python setup.py install\n\nSubstitute ``python`` with your specific version if required, for example\n``python3``, or ``pypy3``.\n\nTo exclude tests that require an internet connection (and which may take a\nlong time), use the ``--offline`` option::\n\n    python setup.py test --offline\n\nIf you need to do additional configuration, e.g. changing the install\ndirectory prefix, please type ``python setup.py``.\n\n\nTesting\n=======\n\nBiopython includes a suite of regression tests to check if everything is\nrunning correctly. To run the tests, go to the biopython source code\ndirectory and type::\n\n    pip install -e .\n    python setup.py test\n\nIf you want to skip the online tests (which is recommended when doing repeated\ntesting), use::\n\n    python setup.py test --offline\n\nDo not panic if you see messages warning of skipped tests::\n\n    test_DocSQL ... skipping. Install MySQLdb if you want to use Bio.DocSQL.\n\nThis most likely means that a package is not installed.  You can\nignore this if it occurs in the tests for a module that you were not\nplanning on using.  If you did want to use that module, please install\nthe required dependency and re-run the tests.\n\nSome of the tests may fail due to network issues, this is often down to\nchance or a service outage. If the problem does not go away on\nre-running the tests, you can use the ``--offline`` option.\n\nThere is more testing information in the Biopython Tutorial \u0026 Cookbook.\n\n\nExperimental code\n=================\n\nBiopython 1.61 introduced a new warning, ``Bio.BiopythonExperimentalWarning``,\nwhich is used to mark any experimental code included in the otherwise\nstable Biopython releases. Such 'beta' level code is ready for wider\ntesting, but still likely to change, and should only be tried by early\nadopters in order to give feedback via the biopython-dev mailing list.\n\nWe'd expect such experimental code to reach stable status within one or two\nreleases, at which point our normal policies about trying to preserve\nbackwards compatibility would apply.\n\n\nBugs\n====\n\nWhile we try to ship a robust package, bugs inevitably pop up.  If you are\nhaving problems that might be caused by a bug in Biopython, it is possible\nthat it has already been identified. Update to the latest release if you are\nnot using it already, and retry. If the problem persists, please search our\nbug database and our mailing lists to see if it has already been reported\n(and hopefully fixed), and if not please do report the bug. We can't fix\nproblems we don't know about ;)\n\nIssue tracker: https://github.com/biopython/biopython/issues\n\nIf you suspect the problem lies within a parser, it is likely that the data\nformat has changed and broken the parsing code.  (The text BLAST and GenBank\nformats seem to be particularly fragile.)  Thus, the parsing code in\nBiopython is sometimes updated faster than we can build Biopython releases.\nYou can get the most recent parser by pulling the relevant files (e.g. the\nones in ``Bio.SeqIO`` or ``Bio.Blast``) from our git repository. However, be\ncareful when doing this, because the code in github is not as well-tested\nas released code, and may contain new dependencies.\n\nIn any bug report, please let us know:\n\n1. Which operating system and hardware (32 bit or 64 bit) you are using\n2. Python version\n3. Biopython version (or git commit/date)\n4. Traceback that occurs (the full error message)\n\nAnd also ideally:\n\n5. Example code that breaks\n6. A data file that causes the problem\n\n\nContributing, Bug Reports\n=========================\n\nBiopython is run by volunteers from all over the world, with many types of\nbackgrounds. We are always looking for people interested in helping with code\ndevelopment, web-site management, documentation writing, technical\nadministration, and whatever else comes up.\n\nIf you wish to contribute, please first read `CONTRIBUTING.rst\n\u003chttps://github.com/biopython/biopython/blob/master/CONTRIBUTING.rst\u003e`_ here,\nvisit our web site http://biopython.org and join our mailing list:\nhttp://biopython.org/wiki/Mailing_lists\n\n\nDistribution Structure\n======================\n\n- ``README.rst``  -- This file.\n- ``NEWS.rst``    -- Release notes and news.\n- ``LICENSE.rst`` -- What you can do with the code.\n- ``CONTRIB.rst`` -- An (incomplete) list of people who helped Biopython in\n  one way or another.\n- ``CONTRIBUTING.rst`` -- An overview about how to contribute to Biopython.\n- ``DEPRECATED.rst`` -- Contains information about modules in Biopython that\n  were removed or no longer recommended for use, and how to update code that\n  uses those modules.\n- ``MANIFEST.in`` -- Configures which files to include in releases.\n- ``setup.py``    -- Installation file.\n- ``Bio/``        -- The main code base code.\n- ``BioSQL/``     -- Code for using Biopython with BioSQL databases.\n- ``Doc/``        -- Documentation.\n- ``Scripts/``    -- Miscellaneous, possibly useful, standalone scripts.\n- ``Tests/``      -- Regression testing code including sample data files.\n","funding_links":[],"categories":["Science","Package suites","Genetics","Python","زیست شناسی و بیوتکنولوژی","Ranked by starred repositories"],"sub_categories":["Packages","کار با زمان و تقویم"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiopython%2Fbiopython","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiopython%2Fbiopython","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiopython%2Fbiopython/lists"}