# PyLips
**PyLips** is a Python-based interface for developing screen-based conversational agents.
It is designed to make developing socially assistive robotics easier by providing a
simple, expressive, and customizable framework for developing conversational agents.
PyLips is easy to install, simple to use, and open-source.
It comes ready to use with your system's speech synthesis tools, and
uses other free and open-source software for turning these sounds into facial expressions.
## To Install from PyPI
You can install PyLips using pip. To install PyLips, run this command in your terminal:
```
python3 -m pip install pylips
```
If you are running PyLips on a Linux Distribution, you may need to also install the following packages:
```
sudo apt update && sudo apt install espeak-ng ffmpeg libespeak1
```
## PyLips Quickstart
Here is a quick example to test your installation. This code will make your computer face say
"Hello, welcome to pylips!". The voice will be the default system voice, but this is something
we can change later.
First, we will have to start the PyLips server. This is a simple flask sever that can serve several
faces at the same time. To start the server, run the following command:
```
python3 -m pylips.face.start
```
This will start the server on port 8000. Do not worry about the warning message, the package will
still work. You can connect any web browser to the urls printed, even across computers on the local network.
For now, just open a browser and go to `http://localhost:8000/face` to see the face.
Now open a new terminal tab and run the following code:
```
from pylips.speech import RobotFace
face = RobotFace()
# you may need to wait here for a minute or two to let allosaurus download on the first run
face.say("Hello, welcome to pylips!")
```
If all goes well, the face should have said the message!
# History
## 0.0.0 (2024-03-24)
- pylips begins
Raw data
{
"_id": null,
"home_page": "https://github.com/interaction-lab/PyLips",
"name": "pylips",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": null,
"keywords": "lipsynch, robot, interaction, conversational, agent",
"author": "Interaction Lab",
"author_email": "dennler@usc.edu",
"download_url": "https://files.pythonhosted.org/packages/22/bd/cca028cae3d5b0c95bfb62459b03b2e44b14166d14a95d8fa5e58ab0204a/pylips-0.0.13.tar.gz",
"platform": null,
"description": "# PyLips\n\n\n\n**PyLips** is a Python-based interface for developing screen-based conversational agents.\nIt is designed to make developing socially assistive robotics easier by providing a\nsimple, expressive, and customizable framework for developing conversational agents.\n\n\nPyLips is easy to install, simple to use, and open-source.\nIt comes ready to use with your system's speech synthesis tools, and\nuses other free and open-source software for turning these sounds into facial expressions.\n\n\n\n## To Install from PyPI\n\nYou can install PyLips using pip. To install PyLips, run this command in your terminal:\n\n```\npython3 -m pip install pylips\n```\n\nIf you are running PyLips on a Linux Distribution, you may need to also install the following packages:\n\n```\nsudo apt update && sudo apt install espeak-ng ffmpeg libespeak1\n```\n\n## PyLips Quickstart\n\nHere is a quick example to test your installation. This code will make your computer face say \n\"Hello, welcome to pylips!\". The voice will be the default system voice, but this is something\nwe can change later.\n\nFirst, we will have to start the PyLips server. This is a simple flask sever that can serve several\nfaces at the same time. To start the server, run the following command:\n\n```\npython3 -m pylips.face.start\n```\n\nThis will start the server on port 8000. Do not worry about the warning message, the package will \nstill work. You can connect any web browser to the urls printed, even across computers on the local network.\nFor now, just open a browser and go to `http://localhost:8000/face` to see the face.\n\nNow open a new terminal tab and run the following code:\n\n```\nfrom pylips.speech import RobotFace\n\nface = RobotFace()\n# you may need to wait here for a minute or two to let allosaurus download on the first run\n\nface.say(\"Hello, welcome to pylips!\")\n```\n\nIf all goes well, the face should have said the message!\n\n\n\n\n# History\n\n## 0.0.0 (2024-03-24)\n\n- pylips begins\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "An interface for embodied conversational interaction.",
"version": "0.0.13",
"project_urls": {
"Homepage": "https://github.com/interaction-lab/PyLips"
},
"split_keywords": [
"lipsynch",
" robot",
" interaction",
" conversational",
" agent"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "36b43e132f43ff2f76bbfb56bb184de45114b0c9abf86b16bf1816578c920e71",
"md5": "932c6a63a17e80918aedb2441ac06219",
"sha256": "1031796d82d6cd3f932e96811a2655537753686120bb579e676a90c0a53a5e79"
},
"downloads": -1,
"filename": "pylips-0.0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "932c6a63a17e80918aedb2441ac06219",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.0",
"size": 90873,
"upload_time": "2024-06-29T02:06:13",
"upload_time_iso_8601": "2024-06-29T02:06:13.918785Z",
"url": "https://files.pythonhosted.org/packages/36/b4/3e132f43ff2f76bbfb56bb184de45114b0c9abf86b16bf1816578c920e71/pylips-0.0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "22bdcca028cae3d5b0c95bfb62459b03b2e44b14166d14a95d8fa5e58ab0204a",
"md5": "f9a67c343febc85db94398557d03026f",
"sha256": "cb6be5ca3db668f9b3dd20ae7b7297e6b972dfbbdcdd985d92e2d27581343015"
},
"downloads": -1,
"filename": "pylips-0.0.13.tar.gz",
"has_sig": false,
"md5_digest": "f9a67c343febc85db94398557d03026f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 89286,
"upload_time": "2024-06-29T02:06:15",
"upload_time_iso_8601": "2024-06-29T02:06:15.793079Z",
"url": "https://files.pythonhosted.org/packages/22/bd/cca028cae3d5b0c95bfb62459b03b2e44b14166d14a95d8fa5e58ab0204a/pylips-0.0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-29 02:06:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "interaction-lab",
"github_project": "PyLips",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pylips"
}
JSON
