A command-line interface for exploring Tamil Kavithaigal (Tamil Poetry).
Tamil Kavi is a simple and intuitive command-line tool designed to provide easy access to a curated collection of Tamil poetry. It empowers users to navigate through poems by listing authors, books, and titles, and by applying filters to find specific content. The poetry data is included as JSON files within the package, making the tool self-contained after installation.
This project serves as a command-line companion and is proudly associated with the website tamilkavi.com, which offers additional details about it.
You can install tamilkavi directly from the Python Package Index (PyPI) using pip, the standard Python package installer:
pip install tamilkavi
This command will download and install the tamilkavi package and its dependencies (like prettytable) automatically.
Once the installation is complete, you can run the tamilkavi command from any terminal window.
Here is the usage information and examples:
Tamil Kavi CLI - Command Line tool for exploring Tamil Kavithaigal.
options:
-h, --help show this help message and exit
-a [AUTHOR_NAME], --authors [AUTHOR_NAME]
Filter by author name (use -a to list all authors)
-b [BOOK_TITLE], --book [BOOK_TITLE]
Filter by book title (use -b to list all books)
-t [POEM_TITLE], --title [POEM_TITLE]
Filter by poem title (use -t to list all unique titles)
Examples:
# List all authors
tamilkavi -a
# List all books from all authors
tamilkavi -b
# List all unique poem titles from all books
tamilkavi -t
# Show books by a specific author
tamilkavi -a "Author Name"
# Show poems from a specific book (by any author, if -a not used)
tamilkavi -b "Book Title"
# Show poems with a specific title (from any book/author, if -a/-b not used)
tamilkavi -t "Poem Title"
# Show poems from a specific book by a specific author
tamilkavi -a "Author Name" -b "Book Title"
# Show poems with a specific title by a specific author
tamilkavi -a "Author Name" -t "Poem Title"
# Show poems with a specific title from a specific book
tamilkavi -b "Book Title" -t "Poem Title"
# Show poems with a specific title from a specific book by a specific author
tamilkavi -a "Author Name" -b "Book Title" -t "Poem Title"
# Get detailed help
tamilkavi -h
We welcome contributions from everyone who wants to help preserve and promote Tamil literature. There are two main ways to contribute poems to our collection:
We are always looking for ways to improve our platform and welcome contributions of new features. If you have an idea for a new feature or improvement, we'd love to hear about it!
Guidelines for Feature Contributions:
Our team will review your pull request and provide feedback. We appreciate your effort in helping us improve this project!
If you're familiar with GitHub, this is our preferred method as it maintains proper versioning and attribution of contributions. You will be directly adding data to the project's source files.
Step-by-Step Process:
tamilkavi/kavisrc/ directory.jothi.json). If the author doesn't exist, create a new JSON file using their name in lowercase.author, contact, and the books array. Ensure the structure for each book and context entry is correct.TamilKavi repository's main branch. Provide a clear title and description of the poems you've added or updated.Sample JSON Structure
{
"author": "jothi",
"contact": "sanand03072005@gamil.com",
"books":[
{
"booktitle": "இன்பமில்லா-இதயத்திலிருந்து",
"booktitle_tanglish": "inbamilla-ithayathilirundhu",
"description": "சாதிக்க தூதிக்கும் ஒரு சாதாரண மாணவன்",
"category": "Feelings",
"context":[
{
"title": "God-Murugan-Song",
"line": "பிறப்பிலும் முருகனை, இறப்பிலும் இறைவனை, அனைத்திலும் அவனை கொண்டு இனிதே தொடங்குவோம்!.",
"meaning": "எனது பிறப்பிலும் முருகனை, எனது இறப்பிலும் அவனை, எனது வாழ்வின் ஒவ்வொரு கட்டத்திலும் அவனை நினைத்து இனிதே தொடங்குவோம்!."
}
// Add more poem contexts here
]
}
// Add more books here
]
}
⚠️ Important: Please ensure the JSON structure is valid and follows the format precisely. Invalid JSON will cause errors.
Not comfortable with GitHub? No problem! You can use our submission form to contribute poems.
What You'll Need:
Sample Document Format
Title: God-Murugan-Song
Kavithai: பிறப்பிலும் முருகனை, இறப்பிலும் இறைவனை, அனைத்திலும் அவனை கொண்டு இனிதே தொடங்குவோம்!.
Meaning: எனது பிறப்பிலும் முருகனை, எனது இறப்பிலும் அவனை, எனது வாழ்வின் ஒவ்வொரு கட்டத்திலும் அவனை நினைத்து இனிதே தொடங்குவோம்!.
Title: Mother-Love
Kavithai: தாலாட்டில் வளர்ந்தவன், தனிமையில் வளரும் கொடுமைகளை, வார்த்தையில் சொல்ல இயலாது.
Meaning: தாயின் மடியில் நன்காக, அன்பாக வளர்க்கப்பட்ட ஒரு குழந்தை, பிறகு தனிமையில் வளர நேரிடும் போது எதிர்கொள்ளும் வேதனைகள் மற்றும் துன்பங்களை வார்த்தைகளால் விவரிக்க முடியாது. அந்த அனுபவம் மிகுந்த மன வேதனையைக் கொடுக்கும்.
⚠️ Important: Please do not submit kavithaigal written by other authors unless you have explicit permission. We will not accept or include plagiarized content.
📦 Once we review and approve your submission, it will be added to our Python Package, listed on the Website – Preview Poems Page, and published in our Hugging Face Dataset.
Our team will review submissions and add them to the repository, with full attribution to the contributor.
This project is released under the MIT License. You are free to use, modify, and distribute the code under the terms of this license. See the LICENSE file in the repository for the full text.
If you have any questions, feedback, or suggestions, feel free to reach out to the authors:
We want to express our gratitude to:
prettytable and importlib.resources.FAQs
A command-line tool for exploring Tamil Kavithaigal.
We found that tamilkavi demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s Threat Research Team has uncovered 60 npm packages using post-install scripts to silently exfiltrate hostnames, IP addresses, DNS servers, and user directories to a Discord-controlled endpoint.
Security News
TypeScript Native Previews offers a 10x faster Go-based compiler, now available on npm for public testing with early editor and language support.
Research
Security News
Malicious npm packages targeting React, Vue, Vite, Node.js, and Quill remained undetected for two years while deploying destructive payloads.