https://github.com/agilescientific/kosu

Build and maintain courses using Jupyter Notebooks.
https://github.com/agilescientific/kosu

courseware education jupyter python

Last synced: 2 months ago
JSON representation

Build and maintain courses using Jupyter Notebooks.

• Host: GitHub
• URL: https://github.com/agilescientific/kosu
• Owner: agilescientific
• License: apache-2.0
• Created: 2022-01-24T19:48:18.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-09-22T20:23:48.000Z (over 2 years ago)
• Last Synced: 2024-10-06T18:46:23.966Z (3 months ago)
• Topics: courseware, education, jupyter, python
• Language: Python
• Homepage: https://code.agilescientific.com/kosu
• Size: 690 KB
• Stars: 3
• Watchers: 3
• Forks: 3
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# kōsu / コース

[![Tests](https://github.com/agilescientific/kosu/actions/workflows/tests.yml/badge.svg)](https://github.com/agilescientific/kosu/actions/workflows/tests.yml)

[![Build docs](https://github.com/agilescientific/kosu/actions/workflows/build-docs.yml/badge.svg)](https://github.com/agilescientific/kosu/actions/workflows/build-docs.yml)

[![PyPI version](https://img.shields.io/pypi/v/kosu.svg)](https://pypi.org/project/kosu/)

[![PyPI versions](https://img.shields.io/pypi/pyversions/kosu.svg)](https://pypi.org/project/kosu/)

[![PyPI license](https://img.shields.io/pypi/l/kosu.svg)](https://pypi.org/project/kosu/)

`kosu` is a command-line utility to help you build and maintain courses using Jupyter Notebooks.

## Installation

To install kosu:

    pip install kosu

Or if you want to upload to S3 later, use the `aws` option like so:

    pip install kosu[aws]

See [the documentation](https://code.agilescientific.com/kosu) for more information.

## Getting started

To set up a new collection of courses:

    mkdir mycourses

    cd mycourses

    kosu init

This will create several directories and files in the directory `mycourses`. You can run some of the other commands in this guide to see how they work.

The content of the course is controlled by `example-course.yaml`. Note that only `title` and `curriculum` are required fields. There is also a global control file, `.kosu.yaml`, which contains some parameters you will want to set and maintain.

To build the example course:

    kosu build example-course

This will create a ZIP file of the course content.

To add more courses using the same pool of content, add another YAML control file.

## Documentation

[Read the documentation](https://code.agilescientific.com/kosu) for more on using the tool, as well as for information about contributing to `kosu`, the licence, etc.