An open API service indexing awesome lists of open source software.

https://github.com/karthikudyawar/url-shorten

URL shortener using python
https://github.com/karthikudyawar/url-shorten

Last synced: 2 months ago
JSON representation

URL shortener using python

Awesome Lists containing this project

README

          

# URL-Shorten

[![Python Version](https://img.shields.io/badge/Python-3.8+-blue.svg?style=flat&logo=python&logoColor=white)](https://www.python.org/)
[![Powered by Poetry](https://img.shields.io/badge/Powered%20by-Poetry-060b55.svg?style=flat&logo=python&logoColor=white)](https://python-poetry.org/)
[![Last Commit](https://img.shields.io/github/last-commit/KarthikUdyawar/URL-Shorten?style=flat)](https://github.com/KarthikUdyawar/URL-Shorten/commits/main)
[![Repo Size](https://img.shields.io/github/repo-size/KarthikUdyawar/URL-Shorten?style=flat)](https://github.com/KarthikUdyawar/URL-Shorten)
[![Open Issues](https://img.shields.io/github/issues/KarthikUdyawar/URL-Shorten?style=flat)](https://github.com/KarthikUdyawar/URL-Shorten/issues)
[![Pull Requests](https://img.shields.io/github/issues-pr/KarthikUdyawar/URL-Shorten?style=flat)](https://github.com/KarthikUdyawar/URL-Shorten/pulls)
[![License](https://img.shields.io/github/license/KarthikUdyawar/URL-Shorten?style=flat)](https://github.com/KarthikUdyawar/URL-Shorten/blob/main/LICENSE)





Logo

URL-Shorten


A simple and lightweight URL shortener built with Python.


Explore the docs ยป




View Demo
ยท
Report Bug
ยท
Request Feature

---

## ๐Ÿ“‹ Table of Contents

- [URL-Shorten](#url-shorten)
- [๐Ÿ“‹ Table of Contents](#-table-of-contents)
- [๐Ÿ›  About The Project](#-about-the-project)
- [๐Ÿš€ Built With](#-built-with)
- [๐Ÿ Getting Started](#-getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [๐Ÿ“š Usage](#-usage)
- [๐Ÿค Contributing](#-contributing)
- [๐Ÿชช License](#-license)
- [๐Ÿ“ฌ Contact](#-contact)
- [๐Ÿ™ Acknowledgements](#-acknowledgements)

---

## ๐Ÿ›  About The Project

![Screenshot](https://github.com/KarthikUdyawar/URL-Shorten/blob/main/images/Screenshot.png)

**URL-Shorten** allows users to easily shorten long URLs with a clean and minimal UI.
Focus is on simplicity, local usage, and zero-dependency outside Python and Poetry.

---

## ๐Ÿš€ Built With

- [Python 3.8+](https://www.python.org/)
- [Poetry](https://python-poetry.org/)

---

## ๐Ÿ Getting Started

### Prerequisites

- Python 3.8 or newer
- Poetry

### Installation

1. Clone the repository:
```bash
git clone https://github.com/KarthikUdyawar/URL-Shorten
cd URL-Shorten
```
2. Install dependencies:
```bash
poetry install
poetry env use python3
```

---

## ๐Ÿ“š Usage

Run the application:

```bash
poetry run python main.py
```

Shorten your URLs easily through the UI!

---

## ๐Ÿค Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feat/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feat/AmazingFeature)
5. Open a Pull Request

---

## ๐Ÿชช License

Distributed under the [MIT License](LICENSE).

---

## ๐Ÿ“ฌ Contact

Karthik Udyawar โ€“ [LinkedIn](https://www.linkedin.com/in/karthik-udyawar-0489991b3) โ€“ karthikajitudy@gmail.com

Project Link: [https://github.com/KarthikUdyawar/URL-Shorten](https://github.com/KarthikUdyawar/URL-Shorten)

---

## ๐Ÿ™ Acknowledgements

- [Poetry](https://python-poetry.org/)
- [Shield.io Badges](https://shields.io)
- [Markdown Guide](https://www.markdownguide.org/)

---