An open API service indexing awesome lists of open source software.

https://github.com/atlassistant/pytlas

An open-source 🤖💬 Python 3 assistant library built for people and made to be super easy to setup and understand
https://github.com/atlassistant/pytlas

ai assistant bot chatbot nlu privacy pytlas self-hosted

Last synced: 3 months ago
JSON representation

An open-source 🤖💬 Python 3 assistant library built for people and made to be super easy to setup and understand

Awesome Lists containing this project

README

          

pytlas |travis| |cover| |pypi| |rtd| |license| |donate| |gitter|
================================================================

.. |travis| image:: https://travis-ci.org/atlassistant/pytlas.svg?branch=master
:target: https://travis-ci.org/atlassistant/pytlas

.. |cover| image:: https://codecov.io/gh/atlassistant/pytlas/branch/master/graph/badge.svg
:target: https://codecov.io/gh/atlassistant/pytlas

.. |pypi| image:: https://badge.fury.io/py/pytlas.svg
:target: https://badge.fury.io/py/pytlas

.. |rtd| image:: https://readthedocs.org/projects/pytlas/badge/?version=latest
:target: https://pytlas.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status

.. |license| image:: https://img.shields.io/badge/License-GPL%20v3-blue.svg
:target: https://www.gnu.org/licenses/gpl-3.0

.. |donate| image:: http://img.shields.io/liberapay/goal/atlassistant.svg?logo=liberapay
:target: https://liberapay.com/atlassistant/donate

.. |gitter| image:: https://img.shields.io/gitter/room/atlassistant/pytlas
:target: https://gitter.im/pytlas/community

An open-source 🤖💬 Python 3 assistant library built for people and made to be super easy to setup and understand.

**pytlas** translates natural language sentences into python skills you can easily define yourself. It makes it really easy to develop your own Google Assistant, Alexa or whatever but runs on **your device** with **your trusted code** and **no connection** to obscure servers.

🎮 Want to try it? Check the `official demo `_!

🌊 Want to get your feet wet? Have a look at the `example/skills` folder to see how it works!

📚 Want to go further and develop your own skill? Let's visit the `latest documentation `_ and share your work!

Quick start
-----------

Installation
~~~~~~~~~~~~

.. code-block:: bash

$ pip install pytlas[snips] # Gets the latest release from pypi
$ git clone https://github.com/atlassistant/pytlas && cd pytlas && pip install -e .[snips] # or directly from source

Testing
~~~~~~~

*When `pytest` is also installed, it may cause some tests to fail, so make sure it is not installed with `pip uninstall -y pytest` or use venv*

.. code-block:: bash

$ git clone https://github.com/atlassistant/pytlas && cd pytlas
$ pip install -e .[snips,test]
$ python -m nose --with-doctest --with-coverage --cover-package=pytlas

Linting
~~~~~~~

.. code-block:: bash

$ pylint pytlas setup.py # in the root directory

Authors
-------

- `Julien Leicher `_
- `Jean-Michel Lekston `_

Contributing
------------

Contributions are **welcome**! **pytlas** is being developed on our spare time so every help is greatly appreciated to push this project further.

I have ideas!
~~~~~~~~~~~~~

Don't hesitate to submit them in the repo and we'll see what can be done.

I have skills & time!
~~~~~~~~~~~~~~~~~~~~~

Great, have a look at `the github project page `_ to see the big plans for upcoming releases or fix unresolved issues to start.

I have money!
~~~~~~~~~~~~~

.. |liberapay| image:: https://liberapay.com/assets/widgets/donate.svg
:target: https://liberapay.com/atlassistant/donate

If you want to donate to help us find more time to work on **pytlas** and similar projects, you can support us on liberapay |liberapay|, thanks ❤️!