indianconstitution 1.1.0

The most developer-friendly way to explore the Constitution of India

IndianConstitution (v1.1.0)

The definitive Python library for the Sovereign Democratic Republic.

indianconstitution is a professional-grade, high-performance framework designed for legal professionals, researchers, and developers. It provides structured, programmatic access to the Articles, Parts, and Schedules of the Constitution of India with an elite CLI and AI-ready architecture.

---

Features

• Pythonic API: Intuitive, type-hinted, and chainable access to all articles.
• High Performance: Inverted index for lightning-fast keyword search and lazy loading.
• World-Class CLI: Beautiful terminal interface powered by Typer and Rich.
• Advanced Search: Keyword, fuzzy, and (optional) semantic search capabilities.
• Data Science Ready: Export to JSON, CSV, and Pandas DataFrames.
• Smart Caching: Local disk caching for heavy operations.

---

Quickstart in 30 Seconds

Installation

pip install indianconstitution

Basic Usage

import indianconstitution as ic

# Get a specific article
article = ic.get_article(14)
print(f"{article.title}: {article.content}")

# Search across the entire constitution
results = ic.search("freedom of speech")
for a in results:
    print(f"Article {a.number}: {a.title}")

---

CLI Interface

The library comes with a powerful command-line interface.

# Get an article
indianconstitution get 21A

# Search for keywords
indianconstitution search "equality"

# View the Preamble
indianconstitution preamble

# Show statistics
indianconstitution stats

---

Advanced Features

Semantic Search (AI-Powered)

Find articles by meaning, not just keywords.

pip install "indianconstitution[ai]"

from indianconstitution import Constitution
ic = Constitution()
results = ic.semantic_search("rights of minority educational institutions")

Pandas Integration

import pandas as pd
df = pd.DataFrame([a.dict() for a in ic.data.articles])

---

Why this library exists?

The Constitution of India is one of the longest written constitutions in the world. Accessing it programmatically should be as elegant as the document itself. This library aims to bridge the gap between legal text and modern development workflows, enabling better research, education, and civic-tech applications.

---

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

Acknowledgments

• This library uses publicly available data from official sources of the Government of India.
• Special thanks to the open-source community for the tools that made this library possible.

Contact

• Author: Vikhram S
• Email: [e-mail]
• GitHub: https://github.com/Vikhram-S/IndianConstitution

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright

Copyright (c) 2026 Vikhram S. All rights reserved.

---

❤️ Support the Project

If this project helps you, consider supporting its continued development and maintenance.

Your support helps with:

• maintaining and improving the package
• adding new features and datasets
• long-term open-source sustainability
• keeping the project free and accessible

❤️ Support the Project

If this project provides value to you or your organization, consider supporting its continued development and maintenance.

Support helps fund:

• ongoing package maintenance and improvements
• new features, datasets, and documentation
• infrastructure, testing, and release automation
• long-term open-source sustainability

Support via UPI (Unified Payments Interface)

UPI ID: vikhrams15@okhdfcbank

Contributions, feature requests, issue reports, documentation improvements, and GitHub stars are also appreciated.