Skip to main content

Minimalist Wikipedia CLI client for terminal dwellers.

Project description

WiCLIpedia

License: AGPL-3.0-or-later Version Supported Versions Tests Code Style: Black

This is a minimalist command line interface (CLI) program to fetch and display data from Wikipedia.

In an era where Artificial Intelligence answers everything and large language models shape our knowledge, this program is a small tribute to Wikipedia, the silent, human-curated backbone that feeds those very models. Never forget the source.


Demo


Features

  • Fetches and displays article summaries and table of contents
  • Navigates article sections interactively
  • Handles redirects and disambiguation pages automatically
  • Supports multiple Wikipedia languages
  • Caches responses locally to minimize API calls
  • ANSI colors and styles for enhanced readability (can be disabled)

Installation

pip install wiclipedia

Usage

wicli "Blade Runner"

If no page title is provided, the program will prompt you to enter one interactively.

You will be interactively prompted to navigate through the article summary sections.
To navigate, use the section numbers shown in the table of contents.

If the query matches a disambiguation page, you will be prompted to select the intended article from a list of options.

By default, it fetches the English Wikipedia.
To specify a different language, use the -l or --lang option:

wicli "La classe operaia va in paradiso" --lang it

Available commands during navigation:

  • :b — Go back to the start prompt
  • :q — Exit the program
  • :m — Show the table of contents menu (only available when navigating sections)

Options

Option Description
page Wikipedia page title (optional, prompted if omitted)
-l, --lang Language code (default: en)
--no-cache Disable local cache for the session
--purge Purge local cache and exit

Cache

Responses are cached locally for 72 hours to reduce API calls.
The cache is stored in ~/.cache/wiclipedia/.
Use --no-cache to bypass it for a session, or --purge to clear it entirely.

Display

ANSI colors and styles are enabled by default.
Set the NO_COLOR environment variable to disable them (see no-color.org).

API Respect and Fair Use Disclaimer

WiCLIpedia interfaces directly with the official Wikipedia PHP/MediaWiki APIs without using any third-party scraping libraries.
Please use this program responsibly. If you need to perform massive automated data extraction, use official database dumps instead of hammering the live API.

WiCLIpedia caches responses locally for 72 hours by default to minimize API load. Check the Cache section for details.

More information about the MediaWiki API and usage guidelines:

License

This program is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
See the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wiclipedia-0.1.4.tar.gz (29.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wiclipedia-0.1.4-py3-none-any.whl (33.3 kB view details)

Uploaded Python 3

File details

Details for the file wiclipedia-0.1.4.tar.gz.

File metadata

  • Download URL: wiclipedia-0.1.4.tar.gz
  • Upload date:
  • Size: 29.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for wiclipedia-0.1.4.tar.gz
Algorithm Hash digest
SHA256 c60cb6484d121a1dd1cb0cd98e3f948e4499388e5659937ce5c0d0f6589cc63c
MD5 0bab6b7d5a09251ddc336534f6bececa
BLAKE2b-256 39b472cf14716f2a517fcaae6b77a0846219e0e18008d4fd63536899cfd5faf6

See more details on using hashes here.

Provenance

The following attestation bundles were made for wiclipedia-0.1.4.tar.gz:

Publisher: publish.yml on seto/wiCLIpedia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file wiclipedia-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: wiclipedia-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 33.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for wiclipedia-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 51a13db97c894448eb6b65e537560ce3ed4da2336b7c88cfc5584f58d6544c7b
MD5 25ece1f510196bf7e1f3f49691093097
BLAKE2b-256 e758be74ed94ef1450b64fb18922a2af5b34982fc2628257f7e2964cecad31e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for wiclipedia-0.1.4-py3-none-any.whl:

Publisher: publish.yml on seto/wiCLIpedia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page