Address Book API

A FastAPI based Address Book application allowing users to:

• Create addresses
• Update addresses
• Delete addresses
• Search addresses within a distance

Tech Stack

FastAPI
Python 3.10+
SQLAlchemy ORM
SQLite
Pydantic Validation
Geopy (distance calculation)

Setup

Clone repository

git clone https://github.com/utkarsh21123/address-book-fastapi.git

cd address-book-fastapi

Create virtual environment

python -m venv venv

Activate environment

source venv/bin/activate

Install dependencies

pip install -r requirements.txt

Run server

uvicorn app.main:app --reload

API Documentation

Open Swagger UI

http://127.0.0.1:8000/docs

Example Query

GET /api/v1/addresses/nearby?lat=28.6139&lon=77.2090&distance=10

Returns all addresses within 10km.