# Rasa Python-SDK
[](https://forum.rasa.com/?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://github.com/RasaHQ/rasa-sdk/actions/runs/)
[](https://coveralls.io/github/RasaHQ/rasa-sdk?branch=main)
[](https://pypi.python.org/pypi/rasa-sdk)
Python SDK for the development of custom actions for Rasa.
<hr />
💡 **We're migrating issues to Jira** 💡
Starting January 2023, issues for Rasa Open Source are located in
[this Jira board](https://rasa-open-source.atlassian.net/browse/OSS). You can browse issues without being logged in;
if you want to create issues, you'll need to create a Jira account.
<hr />
## Installation
To install the SDK run
```bash
pip install rasa-sdk
```
## Compatibility
`rasa-sdk` package:
| SDK version | compatible Rasa version |
|----------------|-----------------------------------|
| `1.0.x` | `>=1.0.x` |
old `rasa_core_sdk` package:
| SDK version | compatible Rasa Core version |
|----------------|----------------------------------------|
| `0.12.x` | `>=0.12.x` |
| `0.11.x` | `0.11.x` |
| not compatible | `<=0.10.x` |
## Usage
Detailed instructions can be found in the Rasa Documentation about
[Custom Actions](https://rasa.com/docs/rasa/core/actions).
## Docker
### Usage
In order to start an action server using implemented custom actions,
you can use the available Docker image `rasa/rasa-sdk`.
Before starting the action server ensure that the folder containing
your actions is handled as Python module and therefore has to contain
a file called `__init__.py`
Then start the action server using:
```bash
docker run -p 5055:5055 --mount type=bind,source=<ABSOLUTE_PATH_TO_YOUR_ACTIONS>,target=/app/actions \
rasa/rasa-sdk:<version>
```
The action server is then available at `http://localhost:5055/webhook`.
### Custom Dependencies
To add custom dependencies you enhance the given Docker image, e.g.:
```
# Extend the official Rasa SDK image
FROM rasa/rasa-sdk:<version>
# Change back to root user to install dependencies
USER root
# To install system dependencies
RUN apt-get update -qq && \
apt-get install -y <NAME_OF_REQUIRED_PACKAGE> && \
apt-get clean && \
rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
# To install packages from PyPI
RUN pip install --no-cache-dir <A_REQUIRED_PACKAGE_ON_PYPI>
# Switch back to non-root to run code
USER 1001
```
## Building from source
Rasa SDK uses Poetry for packaging and dependency management. If you want to build it from source,
you have to install Poetry first. This is how it can be done:
```
curl -sSL https://install.python-poetry.org | python3 -
```
There are several other ways to install Poetry. Please, follow
[the official guide](https://python-poetry.org/docs/#installation) to see all possible options.
To install dependencies and `rasa-sdk` itself in editable mode execute
```
make install
```
## Code Style
To ensure a standardized code style we use the formatter [black](https://github.com/ambv/black).
If your code is not formatted properly, GitHub CI will fail to build.
If you want to automatically format your code on every commit, you can use [pre-commit](https://pre-commit.com/).
Just install it via `pip install pre-commit` and execute `pre-commit install`.
To check and reformat files execute
```
make lint
```
## Steps to release a new version
Releasing a new version is quite simple, as the packages are build and distributed
by GitHub Actions.
*Release steps*:
1. Switch to the branch you want to cut the release from (`main` in case of a
major / minor, the current release branch for patch releases).
2. If this is a minor / major release: Make sure all fixes from currently supported minor versions have been merged from their respective release branches (e.g. 3.3.x) back into main.
3. Run `make release`
4. Create a PR against main or the release branch (e.g. `1.2.x`)
5. Once your PR is merged, pull the release branch locally.
6. Create a tag for a new release (this SHOULD always happen on `main` or release branches), e.g. using
```bash
git tag 1.2.0 -m "next release"
git push origin 1.2.0
```
GitHub Actions will build this tag and push a package to
[pypi](https://pypi.python.org/pypi/rasa-sdk).
6. **If this is a minor release**, a new release branch should be created
pointing to the same commit as the tag to allow for future patch releases,
e.g.
```bash
git checkout -b 1.2.x
git push origin 1.2.x
```
## License
Licensed under the Apache License, Version 2.0. Copyright 2021 Rasa
Technologies GmbH. [Copy of the license](LICENSE.txt).
A list of the Licenses of the dependencies of the project can be found at
the bottom of the
[Libraries Summary](https://libraries.io/github/RasaHQ/rasa-sdk).
Raw data
{
"_id": null,
"home_page": "https://rasa.com",
"name": "rasa-sdk",
"maintainer": "Tom Bocklisch",
"docs_url": null,
"requires_python": "<3.11,>=3.8",
"maintainer_email": "tom@rasa.com",
"keywords": "nlp, machine-learning, machine-learning-library, bot, bots, botkit, rasa conversational-agents, conversational-ai, chatbot, chatbot-framework, bot-framework",
"author": "Rasa Technologies GmbH",
"author_email": "hi@rasa.com",
"download_url": "https://files.pythonhosted.org/packages/5c/e6/9b21ea4cfe791f8f0026fbaace950f061cb03d8b9b30989fd1b78022f308/rasa_sdk-3.8.0.tar.gz",
"platform": null,
"description": "# Rasa Python-SDK\n[](https://forum.rasa.com/?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n[](https://github.com/RasaHQ/rasa-sdk/actions/runs/)\n[](https://coveralls.io/github/RasaHQ/rasa-sdk?branch=main)\n[](https://pypi.python.org/pypi/rasa-sdk)\n\nPython SDK for the development of custom actions for Rasa.\n\n<hr />\n\n\ud83d\udca1 **We're migrating issues to Jira** \ud83d\udca1\n\nStarting January 2023, issues for Rasa Open Source are located in\n[this Jira board](https://rasa-open-source.atlassian.net/browse/OSS). You can browse issues without being logged in;\nif you want to create issues, you'll need to create a Jira account.\n\n<hr />\n\n## Installation\n\nTo install the SDK run\n\n```bash\npip install rasa-sdk\n```\n\n## Compatibility\n\n`rasa-sdk` package:\n\n| SDK version | compatible Rasa version |\n|----------------|-----------------------------------|\n| `1.0.x` | `>=1.0.x` |\n\nold `rasa_core_sdk` package:\n\n| SDK version | compatible Rasa Core version |\n|----------------|----------------------------------------|\n| `0.12.x` | `>=0.12.x` |\n| `0.11.x` | `0.11.x` |\n| not compatible | `<=0.10.x` |\n\n## Usage\n\nDetailed instructions can be found in the Rasa Documentation about\n[Custom Actions](https://rasa.com/docs/rasa/core/actions).\n\n## Docker\n\n### Usage\n\nIn order to start an action server using implemented custom actions,\nyou can use the available Docker image `rasa/rasa-sdk`.\n\nBefore starting the action server ensure that the folder containing\nyour actions is handled as Python module and therefore has to contain\na file called `__init__.py`\n\nThen start the action server using:\n\n```bash\ndocker run -p 5055:5055 --mount type=bind,source=<ABSOLUTE_PATH_TO_YOUR_ACTIONS>,target=/app/actions \\\n\trasa/rasa-sdk:<version>\n```\n\nThe action server is then available at `http://localhost:5055/webhook`.\n\n### Custom Dependencies\n\nTo add custom dependencies you enhance the given Docker image, e.g.:\n\n```\n# Extend the official Rasa SDK image\nFROM rasa/rasa-sdk:<version>\n\n# Change back to root user to install dependencies\nUSER root\n\n# To install system dependencies\nRUN apt-get update -qq && \\\n apt-get install -y <NAME_OF_REQUIRED_PACKAGE> && \\\n apt-get clean && \\\n rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*\n\n# To install packages from PyPI\nRUN pip install --no-cache-dir <A_REQUIRED_PACKAGE_ON_PYPI>\n\n# Switch back to non-root to run code\nUSER 1001\n```\n\n## Building from source\n\nRasa SDK uses Poetry for packaging and dependency management. If you want to build it from source,\nyou have to install Poetry first. This is how it can be done:\n\n```\ncurl -sSL https://install.python-poetry.org | python3 -\n```\n\nThere are several other ways to install Poetry. Please, follow\n[the official guide](https://python-poetry.org/docs/#installation) to see all possible options.\n\nTo install dependencies and `rasa-sdk` itself in editable mode execute\n```\nmake install\n```\n\n## Code Style\n\nTo ensure a standardized code style we use the formatter [black](https://github.com/ambv/black).\nIf your code is not formatted properly, GitHub CI will fail to build.\n\nIf you want to automatically format your code on every commit, you can use [pre-commit](https://pre-commit.com/).\nJust install it via `pip install pre-commit` and execute `pre-commit install`.\n\nTo check and reformat files execute\n```\nmake lint\n```\n\n## Steps to release a new version\nReleasing a new version is quite simple, as the packages are build and distributed\nby GitHub Actions.\n\n*Release steps*:\n1. Switch to the branch you want to cut the release from (`main` in case of a\n major / minor, the current release branch for patch releases).\n2. If this is a minor / major release: Make sure all fixes from currently supported minor versions have been merged from their respective release branches (e.g. 3.3.x) back into main.\n3. Run `make release`\n4. Create a PR against main or the release branch (e.g. `1.2.x`)\n5. Once your PR is merged, pull the release branch locally.\n6. Create a tag for a new release (this SHOULD always happen on `main` or release branches), e.g. using\n ```bash\n git tag 1.2.0 -m \"next release\"\n git push origin 1.2.0\n ```\n GitHub Actions will build this tag and push a package to\n [pypi](https://pypi.python.org/pypi/rasa-sdk).\n6. **If this is a minor release**, a new release branch should be created\n pointing to the same commit as the tag to allow for future patch releases,\n e.g.\n ```bash\n git checkout -b 1.2.x\n git push origin 1.2.x\n ```\n\n## License\nLicensed under the Apache License, Version 2.0. Copyright 2021 Rasa\nTechnologies GmbH. [Copy of the license](LICENSE.txt).\n\nA list of the Licenses of the dependencies of the project can be found at\nthe bottom of the\n[Libraries Summary](https://libraries.io/github/RasaHQ/rasa-sdk).\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Open source machine learning framework to automate text- and voice-based conversations: NLU, dialogue management, connect to Slack, Facebook, and more - Create chatbots and voice assistants",
"version": "3.8.0",
"project_urls": {
"Documentation": "https://rasa.com/docs",
"Homepage": "https://rasa.com",
"Repository": "https://github.com/rasahq/rasa-sdk"
},
"split_keywords": [
"nlp",
" machine-learning",
" machine-learning-library",
" bot",
" bots",
" botkit",
" rasa conversational-agents",
" conversational-ai",
" chatbot",
" chatbot-framework",
" bot-framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "539c635313db30757f09c165f364bdb4746a9c8068c906f51096bc8a7f207031",
"md5": "98e02f1258edb8225de2dbe4798be0ea",
"sha256": "d2258651b54bb0f60367d1d517e112b7164809b72ed3bd0206ca1318ac22ad84"
},
"downloads": -1,
"filename": "rasa_sdk-3.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "98e02f1258edb8225de2dbe4798be0ea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.8",
"size": 54046,
"upload_time": "2024-04-03T09:36:11",
"upload_time_iso_8601": "2024-04-03T09:36:11.070152Z",
"url": "https://files.pythonhosted.org/packages/53/9c/635313db30757f09c165f364bdb4746a9c8068c906f51096bc8a7f207031/rasa_sdk-3.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5ce69b21ea4cfe791f8f0026fbaace950f061cb03d8b9b30989fd1b78022f308",
"md5": "ec269d8dc0cf853bb92aaec9f641ea0e",
"sha256": "3ac9b1e53a18be5ae053a78a27ad3d382126618e72dd2f64d80586779f450966"
},
"downloads": -1,
"filename": "rasa_sdk-3.8.0.tar.gz",
"has_sig": false,
"md5_digest": "ec269d8dc0cf853bb92aaec9f641ea0e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.8",
"size": 40773,
"upload_time": "2024-04-03T09:36:12",
"upload_time_iso_8601": "2024-04-03T09:36:12.933539Z",
"url": "https://files.pythonhosted.org/packages/5c/e6/9b21ea4cfe791f8f0026fbaace950f061cb03d8b9b30989fd1b78022f308/rasa_sdk-3.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-03 09:36:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rasahq",
"github_project": "rasa-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "rasa-sdk"
}
JSON
