Skip to content

Conversation

@jsstevenson
Copy link
Member

@jsstevenson jsstevenson commented Jan 23, 2026

close #25

  • Move stuff from @larrybabb 's big PR from the README out into the docs.
  • Add basic features/usage overview
  • Add other docs boilerplate
  • I was intentionally light in some places w/ the expectation that we might change things a bit -- this was just supposed to be enough to get us through an initial release. For example, I'm not sure it's really meaningful to provide much of an API reference when AnyVLM might be used primarily via REST.

Viewable here: https://anyvlm--70.org.readthedocs.build/en/70/

@korikuzma to add github changelog API token as env var where needed if it's not already there

@jsstevenson jsstevenson added the priority:medium Medium priority label Jan 23, 2026
@korikuzma
Copy link
Member

@korikuzma to add github changelog API token as env var where needed if it's not already there

Done

@jsstevenson jsstevenson marked this pull request as ready for review January 23, 2026 17:06
@jsstevenson jsstevenson requested a review from a team as a code owner January 23, 2026 17:06
Copy link
Member

@korikuzma korikuzma left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Small things

make up-dev

# Or production mode
ANYVLM_VERSION=latest make up
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't need ANYVLM_VERSION for prod

Suggested change
ANYVLM_VERSION=latest make up
make up


.. code-block:: console

% docker compose -f compose.dev.yaml -f compose.anyvar.yaml up --build
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When using docker commands directly instead of make shortcuts, we have to set ANYVLM_VERSION

Suggested change
% docker compose -f compose.dev.yaml -f compose.anyvar.yaml up --build
% ANYVLM_VERSION=0.0.0 docker compose -f compose.dev.yaml -f compose.anyvar.yaml up --build


% docker compose -f compose.dev.yaml -f compose.anyvar.yaml up --build

Once the containers are running, visit `http://127.0.0.1:8080/docs <http://127.0.0.1:8080/docs>`_ to view the interactive Swagger UI and confirm the service is responding.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once the containers are running, visit `http://127.0.0.1:8080/docs <http://127.0.0.1:8080/docs>`_ to view the interactive Swagger UI and confirm the service is responding.
Once the containers are running, visit `http://127.0.0.1:8080<http://127.0.0.1:8080>`_ to view the interactive Swagger UI and confirm the service is responding.


At present, AnyVLM serves `Cohort Allele Frequency (CAF) <https://va-spec.ga4gh.org/en/1.0/va-standard-profiles/base-profiles/study-result-profiles.html#cohort-allele-frequency-study-result>`_ objects, describing the frequency of an allele in a cohort. CAF objects may also report additional data, including frequency broken down by zygosity and quality control filters declared by the original variant calls.

.. figure:: /_static/img/caf.png
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This version of AnyVLM validates data using the following data standards:


.. list-table::
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Love this

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority:medium Medium priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add ReadTheDocs

3 participants