Skip to main content

Plugin for a learning assistant backend, intended for use within edx-platform

Project description

learning-assistant

PyPI CI Codecov Documentation Supported Python versions License status-badge

Purpose

Plugin for a learning assistant backend, intended for use within edx-platform.

This library contains data models and logic for a platform wide learning assistant.

Dependencies

In addition to the edx-platform repository in which this library is installed, this plugin also leverages the frontend-lib-learning-assistant as a frontend interface for the learning assistant.

Getting Started

Developing

One Time Setup

# Clone the repository
git clone git@github.com:openedx/learning-assistant.git
cd learning-assistant

# Set up a virtualenv with the same name as the repo and activate it
# Here's how you might do that if you have virtualenvwrapper setup.
mkvirtualenv -p python3.8 learning-assistant

Every time you develop something in this repo

# Activate the virtualenv
# Here's how you might do that if you're using virtualenvwrapper.
workon learning-assistant

# Grab the latest code
git checkout main
git pull

# Install/update the dev requirements
make requirements

# Run the tests and quality checks (to verify the status before you make any changes)
make validate

# Make a new branch for your changes
git checkout -b <your_github_username>/<short_description>

# Using your favorite editor, edit the code to make your change.
vim ...

# Run your new tests
pytest ./path/to/new/tests

# Run all the tests and quality checks
make validate

# Commit all your changes
git commit ...
git push

# Open a PR and ask for review.

License

The code in this repository is licensed under the AGPL 3.0 unless otherwise noted.

Please see LICENSE.txt for details.

Contributing

This repo is not currently accepting contributions.

The Open edX Code of Conduct

All community members are expected to follow the Open edX Code of Conduct.

Reporting Security Issues

Please do not report security issues in public. Please email security@edx.org.

Change Log

Unreleased

4.4.4 - 2024-11-06

  • Fixed Learning Assistant History endpoint

  • Added timestamp to the Learning Assistant History payload

4.4.3 - 2024-11-06

  • Fixed package version

4.4.2 - 2024-11-04

  • Added chat messages to the DB

4.4.1 - 2024-10-31

  • Add management command to remove expired messages

4.4.0 - 2024-10-30

  • Add LearningAssistantMessage model

  • Add new GET endpoint to retrieve a user’s message history in a given course.

4.3.3 - 2024-10-15

  • Use LEARNING_ASSISTANT_PROMPT_TEMPLATE for prompt

4.3.2 - 2024-09-19

  • Add error handling for invalid unit usage keys

4.3.1 - 2024-09-10

  • Remove GPT model field as part of POST request to Xpert backend

4.3.0 - 2024-07-01

  • Adds optional parameter to use updated prompt and model for the chat response.

4.2.0 - 2024-02-28

  • Modify call to Xpert backend to prevent use of course index.

4.1.0 - 2024-02-26

  • Use course cache to inject course title and course skill names into prompt template.

4.0.0 - 2024-02-21

  • Remove use of course waffle flag. Use the django setting LEARNING_ASSISTANT_AVAILABLE to enable the learning assistant feature.

3.6.0 - 2024-02-13

  • Enable backend access by course waffle flag or django setting.

3.4.0 - 2024-01-30

  • Add new GET endpoint to retrieve whether Learning Assistant is enabled in a given course.

3.3.0 - 2024-01-30

  • Fix release version

3.2.0 - 2024-01-30

  • Remove audit access to chat view.

3.0.1 - 2024-01-29

  • Modify gating of learning assistant based on waffle flag and enabled value.

3.0.0 - 2024-01-23

  • Remove and drop the course prompt model.

2.0.3 - 2024-01-22

  • Remove references to the course prompt model.

2.0.1 - 2024-01-08

  • Gate content integration with waffle flag

2.0.0 - 2024-01-03

  • Add content cache

  • Integrate system prompt setting

1.5.0 - 2023-10-18

  • Add management command to generate course prompts

1.4.0 - 2023-09-11

  • Send reduced message list if needed to avoid going over token limit

1.3.3 - 2023-09-07

  • Allow any enrolled learner to access API.

1.3.2 - 2023-08-25

  • Remove deserialization of prompt field, as it is represented in the python native format

1.3.1 - 2023-08-24

  • Remove prompt field

1.3.0 - 2023-08-24

  • Remove references to prompt field

  • Create json_prompt field to allow for more flexible prompts

1.2.1 - 2023-08-24

  • make prompt field nullable

1.2.0 - 2023-08-22

  • add endpoint authentication

  • fix request structure required for endpoint integration

1.1.0 - 2023-08-09

  • fix for course id to course key conversion

1.0.0 - 2023-08-08

  • Add endpoint to retrieve chat response

  • Created model to associate course ideas with a specific prompt text

Unreleased

0.1.0 – 2023-07-26

Added

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

learning_assistant-4.4.4.tar.gz (42.6 kB view details)

Uploaded Source

Built Distribution

learning_assistant-4.4.4-py2.py3-none-any.whl (38.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file learning_assistant-4.4.4.tar.gz.

File metadata

  • Download URL: learning_assistant-4.4.4.tar.gz
  • Upload date:
  • Size: 42.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.9.20

File hashes

Hashes for learning_assistant-4.4.4.tar.gz
Algorithm Hash digest
SHA256 2fb64e16d9a71947c35ad73e2284ab04c87d5f37089e2b4bb36cbeb7643e502e
MD5 553adbde048a77e911e20cf410fc8ee0
BLAKE2b-256 457807e1f828fefc218baa585948b837c31791ffc76d06d0c8bd09fd7dc442fd

See more details on using hashes here.

File details

Details for the file learning_assistant-4.4.4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for learning_assistant-4.4.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4164c57da65665e6641923a5a23ba30cf73bcadb37372d21fd3402d2e7f5c961
MD5 ddefe7b2d3e75a95433f4f6909ef9978
BLAKE2b-256 23f1b13e7cd414345da6735dd4e9783a8b0e2cd3ecfc1b857a3d4bf2b44b3c80

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page