ChirpTools

A Flask application to manage ChirpStack assets (bulk import, bulk move, bulk delete, etc.).

📦 Requirements ::

• Git
• Python 3.9+
• Docker & Docker Compose (for containerized setup)

🧪 Clone the Repository

git clone https://gitlab.opencode.de/smart-city-potsdam/udp-lorawan/tools.git
cd ChirpTools

⚙️ Environment Configuration

Copy .env.example to .env and adjust environment variables as needed:

cp .env.example .env

---

🐳 Run with Docker

Build and run the app using Docker Compose:

docker-compose up --build

• App will be available at: http://localhost:5000
• Make sure .env is configured correctly before running

To stop the app:

docker-compose down

---

🧪 Run Locally (Python venv)

1. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

2. Install requirements:

pip install -r requirements.txt

3. Set environment variables from .env (or export them manually)

4. Start the Flask app:

python -m flask --app main run --debug

App will be accessible at: http://localhost:5000

---

Warning:

⚠️ Authentication is not yet implemented.
🚫 Do not expose this app to the public.
🔒 Keep it local until authentication is added.