# wordcloud-webui
The web UI for word_cloud (text to word cloud picture converter)
## 描述(Description)
- 功能:利用 [word_cloud](https://github.com/amueller/word_cloud) 将 **普通文本** 转为 **词云图像** 文件
- 可视化:使用 [Gradio](https://github.com/gradio-app/gradio) 将该功能可视化
## 界面(UI)
![image.png](https://raw.githubusercontent.com/AlionSSS/wordcloud-webui/main/doc-resources/image.png)
## 安装(Install)
- 新建一个虚拟环境(Python 3.9.16),或使用已有的Python环境
- 例如 `$ conda create -n env_name python=3.9`
- 使用 PIP 方式安装
- `$ pip install wordcloud-webui`
- 使用源码方式安装
- 下载本项目代码
- 点击[本项目GitHub页面](https://github.com/AlionSSS/wordcloud-webui)右上角的绿色的按钮`Code`,再点击`Download ZIP`
- 解压项目,进入到项目根目录
- 安装,执行 `$ pip install -e ./ -i "https://pypi.doubanio.com/simple/"`
- 注
- 卸载命令 `$ pip uninstall wordcloud-webui"`
## 启动服务(Start Service)
### 直接启动
- 由于安装时已经在当前 Python 环境中安装了 script
- 所以可以在任意位置直接执行 `$ wordcloud-gui`,启动 WebUI
### 使用代码启动
- 进入到本项目的目录下,执行 `$ cd src/wordcloud_webui`
- 二选一
- 在本地电脑端启动,直接执行 `$ python main.py`
- 在服务器端启动,执行 `$ nohup python main.py 1>server_run.log 2>&1 &`
## 手动构建(Build)
- 更新、安装工具
- `$ pip install --upgrade setuptools`
- `$ pip install --upgrade build`
- 进入到项目根目录下,执行 `$ python -m build`
- 构建完成会在项目 dist 目录下,生成 tar.gz 和 whl 文件
- 直接使用 PIP 即可安装,如 `pip install .\dist\wordcloud_webui-0.1.0-py3-none-any.whl`
Raw data
{
"_id": null,
"home_page": null,
"name": "wordcloud-webui",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "word-cloud, ui, webui, graph, picture, converter, text",
"author": null,
"author_email": "Lion A <alionsss@foxmail.com>",
"download_url": "https://files.pythonhosted.org/packages/86/99/e76ad1cdf02c8ca3eb69a68662dd5ccf53cb3365dcfb658f6c79285cd79c/wordcloud_webui-0.1.0.tar.gz",
"platform": null,
"description": "# wordcloud-webui\r\nThe web UI for word_cloud (text to word cloud picture converter)\r\n\r\n## \u63cf\u8ff0(Description)\r\n\r\n- \u529f\u80fd\uff1a\u5229\u7528 [word_cloud](https://github.com/amueller/word_cloud) \u5c06 **\u666e\u901a\u6587\u672c** \u8f6c\u4e3a **\u8bcd\u4e91\u56fe\u50cf** \u6587\u4ef6\r\n- \u53ef\u89c6\u5316\uff1a\u4f7f\u7528 [Gradio](https://github.com/gradio-app/gradio) \u5c06\u8be5\u529f\u80fd\u53ef\u89c6\u5316\r\n\r\n## \u754c\u9762(UI)\r\n![image.png](https://raw.githubusercontent.com/AlionSSS/wordcloud-webui/main/doc-resources/image.png)\r\n\r\n## \u5b89\u88c5(Install)\r\n- \u65b0\u5efa\u4e00\u4e2a\u865a\u62df\u73af\u5883(Python 3.9.16)\uff0c\u6216\u4f7f\u7528\u5df2\u6709\u7684Python\u73af\u5883\r\n - \u4f8b\u5982 `$ conda create -n env_name python=3.9`\r\n- \u4f7f\u7528 PIP \u65b9\u5f0f\u5b89\u88c5\r\n - `$ pip install wordcloud-webui`\r\n- \u4f7f\u7528\u6e90\u7801\u65b9\u5f0f\u5b89\u88c5\r\n - \u4e0b\u8f7d\u672c\u9879\u76ee\u4ee3\u7801\r\n - \u70b9\u51fb[\u672c\u9879\u76eeGitHub\u9875\u9762](https://github.com/AlionSSS/wordcloud-webui)\u53f3\u4e0a\u89d2\u7684\u7eff\u8272\u7684\u6309\u94ae`Code`\uff0c\u518d\u70b9\u51fb`Download ZIP`\r\n - \u89e3\u538b\u9879\u76ee\uff0c\u8fdb\u5165\u5230\u9879\u76ee\u6839\u76ee\u5f55\r\n - \u5b89\u88c5\uff0c\u6267\u884c `$ pip install -e ./ -i \"https://pypi.doubanio.com/simple/\"`\r\n- \u6ce8\r\n - \u5378\u8f7d\u547d\u4ee4 `$ pip uninstall wordcloud-webui\"`\r\n\r\n## \u542f\u52a8\u670d\u52a1(Start Service)\r\n### \u76f4\u63a5\u542f\u52a8\r\n- \u7531\u4e8e\u5b89\u88c5\u65f6\u5df2\u7ecf\u5728\u5f53\u524d Python \u73af\u5883\u4e2d\u5b89\u88c5\u4e86 script\r\n- \u6240\u4ee5\u53ef\u4ee5\u5728\u4efb\u610f\u4f4d\u7f6e\u76f4\u63a5\u6267\u884c `$ wordcloud-gui`\uff0c\u542f\u52a8 WebUI\r\n\r\n### \u4f7f\u7528\u4ee3\u7801\u542f\u52a8\r\n- \u8fdb\u5165\u5230\u672c\u9879\u76ee\u7684\u76ee\u5f55\u4e0b\uff0c\u6267\u884c `$ cd src/wordcloud_webui`\r\n- \u4e8c\u9009\u4e00\r\n - \u5728\u672c\u5730\u7535\u8111\u7aef\u542f\u52a8\uff0c\u76f4\u63a5\u6267\u884c `$ python main.py`\r\n - \u5728\u670d\u52a1\u5668\u7aef\u542f\u52a8\uff0c\u6267\u884c `$ nohup python main.py 1>server_run.log 2>&1 &`\r\n\r\n## \u624b\u52a8\u6784\u5efa(Build)\r\n- \u66f4\u65b0\u3001\u5b89\u88c5\u5de5\u5177\r\n - `$ pip install --upgrade setuptools`\r\n - `$ pip install --upgrade build`\r\n- \u8fdb\u5165\u5230\u9879\u76ee\u6839\u76ee\u5f55\u4e0b\uff0c\u6267\u884c `$ python -m build`\r\n- \u6784\u5efa\u5b8c\u6210\u4f1a\u5728\u9879\u76ee dist \u76ee\u5f55\u4e0b\uff0c\u751f\u6210 tar.gz \u548c whl \u6587\u4ef6\r\n- \u76f4\u63a5\u4f7f\u7528 PIP \u5373\u53ef\u5b89\u88c5\uff0c\u5982 `pip install .\\dist\\wordcloud_webui-0.1.0-py3-none-any.whl`\r\n",
"bugtrack_url": null,
"license": "License :: OSI Approved :: Apache Software License",
"summary": "The web UI for word_cloud (text to word cloud picture converter)",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/AlionSSS/wordcloud-webui",
"Repository": "https://github.com/AlionSSS/wordcloud-webui.git"
},
"split_keywords": [
"word-cloud",
" ui",
" webui",
" graph",
" picture",
" converter",
" text"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eceec3720a95cd05825d8064155e93d2496d054343ca63a972d160cc108ccd99",
"md5": "297262e8b2f201f2bb077ea0db1a34d0",
"sha256": "9769ccf226f2358a76d7b750e5db6b43989dc773b11e369eb7351a4c3803eab6"
},
"downloads": -1,
"filename": "wordcloud_webui-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "297262e8b2f201f2bb077ea0db1a34d0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 19993637,
"upload_time": "2024-06-08T11:11:50",
"upload_time_iso_8601": "2024-06-08T11:11:50.269770Z",
"url": "https://files.pythonhosted.org/packages/ec/ee/c3720a95cd05825d8064155e93d2496d054343ca63a972d160cc108ccd99/wordcloud_webui-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8699e76ad1cdf02c8ca3eb69a68662dd5ccf53cb3365dcfb658f6c79285cd79c",
"md5": "17f7dd0369985dd223f5779a4cb8415d",
"sha256": "57c85708d1832c645f309c9bfe314f7cddd5bfbb6d96a891154523753068fc72"
},
"downloads": -1,
"filename": "wordcloud_webui-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "17f7dd0369985dd223f5779a4cb8415d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 19990762,
"upload_time": "2024-06-08T11:12:15",
"upload_time_iso_8601": "2024-06-08T11:12:15.871051Z",
"url": "https://files.pythonhosted.org/packages/86/99/e76ad1cdf02c8ca3eb69a68662dd5ccf53cb3365dcfb658f6c79285cd79c/wordcloud_webui-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-08 11:12:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AlionSSS",
"github_project": "wordcloud-webui",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "wordcloud-webui"
}