Skip to content

Contributing¤

The LynxKite 2000:MM repository lives at https://github.com/lynxkite/lynxkite-2000. Bug reports, feature requests, and pull requests are welcome!

Project structure¤

  • lynxkite-core: Core types and utilities. Depend on this lightweight package if you are writing LynxKite plugins.
  • lynxkite-app: The LynxKite web application. Install some plugins then run this to use LynxKite.
  • lynxkite-graph-analytics: Graph analytics plugin. The classical LynxKite experience!
  • lynxkite-pillow: A simple example plugin.
  • docs: User-facing documentation. It's shared between all packages.

Development setup¤

Install everything like this:

uv venv
source .venv/bin/activate
uvx pre-commit install
uv sync

This also builds the frontend, hopefully very quickly. To run it:

cd examples
lynxkite

If you also want to make changes to the frontend with hot reloading:

cd lynxkite-app/web
npm run dev

Executing tests¤

pytest                                # Runs all backend unit tests.
pytest lynxkite-core                  # Runs tests for one package.
cd lynxkite-app/web && npm run test   # Runs frontend tests.

Documentation¤

To work on the documentation:

mkdocs serve