{"id":34054482,"url":"https://github.com/elena563/wordviz","last_synced_at":"2026-03-27T04:32:15.699Z","repository":{"id":290956017,"uuid":"976108154","full_name":"elena563/wordviz","owner":"elena563","description":"WordViz is a Python visualization library designed for exploring and visualizing word embeddings. ","archived":false,"fork":false,"pushed_at":"2025-09-19T09:04:48.000Z","size":12538,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-19T11:27:31.352Z","etag":null,"topics":["bert","clustering","contextual-embeddings","cosine-similarity","data-visualization","nlp","python3","scatterplot","word-embeddings"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elena563.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-01T14:05:54.000Z","updated_at":"2025-09-19T09:32:21.000Z","dependencies_parsed_at":"2025-07-30T15:14:33.848Z","dependency_job_id":"be145a88-44d2-4732-a28a-319690811455","html_url":"https://github.com/elena563/wordviz","commit_stats":null,"previous_names":["elena563/wordviz"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/elena563/wordviz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elena563%2Fwordviz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elena563%2Fwordviz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elena563%2Fwordviz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elena563%2Fwordviz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elena563","download_url":"https://codeload.github.com/elena563/wordviz/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elena563%2Fwordviz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31019507,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T03:51:26.850Z","status":"ssl_error","status_checked_at":"2026-03-27T03:51:09.693Z","response_time":164,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bert","clustering","contextual-embeddings","cosine-similarity","data-visualization","nlp","python3","scatterplot","word-embeddings"],"created_at":"2025-12-14T02:16:18.650Z","updated_at":"2026-03-27T04:32:15.686Z","avatar_url":"https://github.com/elena563.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![image](https://github.com/elena563/wordviz/blob/master/images/logo.png)\n\n**WordViz** is a Python visualization library designed for exploring and visualizing word embeddings. Built on top of popular libraries such as `matplotlib`, `plotly`, and `gensim`, WordViz provides intuitive tools for analyzing embeddings through clustering, similarity exploration, and dimensionality reduction, all wrapped in interactive and customizable plots.\nWith WordViz, users can gain insights into the structure of their word embeddings, making it a valuable tool for researchers and practitioners in natural language processing.\n\nThis project was created as part of my Bachelor's Degree thesis in Statistics and Information Management with title (translated): \"Word Embeddings in Practice: Designing a Library for Visualization and Operations\"\n\nversion 0.3.0\n\nPyPi Page: https://pypi.org/project/wordviz/  \nDocumentation: https://wordviz.readthedocs.io/\n\n## Last Version Updates\n### Added\n- Support for contextual embeddings with two modes:\n  * `sentences`: visualize entire sentences\n  * `word_contexts`: visualize and compare multiple embeddings of the same word in different contexts\n- New `encoding` module to embed sentences and words in different contexts, supported by Transformers and PyTorch (optional requirements)\n- `load_contextual` method for `EmbeddingLoader` class\n- New `type` property for `EmbeddingLoader` class\n\n### Deprecated\n- From `/plotting`:\n  * `interactive_embeddings` will change name to `plot_interactive` (FutureWarning added)\n  * `similarity_heatmap` will change name to `plot_similarity_heatmap` (FutureWarning added)\n- Warnings added for imminent property name changes in similarity module and `plot_similarity` (no breaking changes yet)\n\n### Fixed\n- Fixed doubled parameter bug in MDS dimensionality reduction\n- Fixed support to pairwise distances for all distance types\n\nSee more about previous changes in [CHANGELOG.md](CHANGELOG.md)\n\n\n## Main Features\n\n- Load and explore pretrained embeddings (e.g., GloVe, FastText)\n- Select from a variety of available embeddings\n- Visualize embeddings in 2D or 3D with flexible dimensionality reduction options\n- Identify and plot the most similar words to a given token\n- Visualize clusters of related words\n- Interactive plots powered by `plotly`\n- Support for many light and dark themes\n\n\n## Installation\n\nInstall the latest version from PyPI:\n\n```bash\npip install wordviz\n```\n\n### Notes: Python version compatibility\n\nCurrently, wordviz is not compatible with Python 3.13, due to limitations of some key dependencies:\n\ngensim, one of the core libraries used by wordviz, does not yet provide official support or precompiled wheels for Python 3.13.\n\nFor proper installation installation, we recommend that you create a virtual environment with Python 3.12, or just use uv:\n\n```bash\nuv init --python 3.12\n```\n\nThe package will be updated as soon as the dependencies are compatible with Python 3.13.\n\n\n## Usage\n\nYou can load and manage embeddings though the `EmbeddingLoader` class, and then visualize them with the `Visualizer` (or `Visualizer3D`) class.\n\n```python\nfrom wordviz.loading import EmbeddingLoader\nfrom wordviz.plotting import Visualizer\n\nloader = EmbeddingLoader()\nloader.load_from_file('path/to/your/embedding/file', 'word2vec')\n\nvis = Visualizer(loader)\nvis.plot_embeddings()\n```\n\nYou can explore all functionalities through the example notebook provided in the `docs/` folder:\n\n👉 [View example notebook](docs/example.ipynb)\n\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\n## License\n\nThis project is licensed under the MIT License.\n\n\n## Contacts\n\nElena Zen - [My Portfolio Website](https://elenazen.it) - info.elenazen@gmail.com","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felena563%2Fwordviz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felena563%2Fwordviz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felena563%2Fwordviz/lists"}