keannu125/auxoscloud_fastapi
1
0
Fork 0
mirror of https://github.com/lemeow125/auxoscloud_fastapi.git synced 2026-08-12 17:11:56 +08:00
Code Issues Projects Releases Packages 1 Wiki Activity
A simple barebones API to quickly expose data on your Auxos inverter
39 commits 1 branch 0 tags 386 KiB
  • Python 53.6%
  • Bru 42.9%
  • Dockerfile 3.5%
Find a file
Exact
Keannu Bernasol b522c999c1 Fix serial number erroring out when faked
2026-08-02 22:09:54 +08:00
.bruno Remove unused auth header in collection 2026-08-02 21:27:21 +08:00
.woodpecker Update deploy step to bump version in .env 2026-08-02 20:46:31 +08:00
api/auxos Trim on retry attempts 2026-08-02 22:03:33 +08:00
config Fix serial number erroring out when faked 2026-08-02 22:09:54 +08:00
.dockerignore Update to correct .bruno directory 2026-08-02 20:55:15 +08:00
.env.sample Overhaul and optimize codebase, add pre-deployment tests 2026-08-02 19:56:08 +08:00
.gitignore Initial commit 2026-03-20 01:22:52 +08:00
.python-version Initial commit 2026-03-20 01:22:52 +08:00
docker-compose.yml Remove build entry in docker-compose 2026-08-02 20:54:17 +08:00
Dockerfile Add default command to Dockerfile 2026-08-02 20:07:41 +08:00
main.py Overhaul and optimize codebase, add pre-deployment tests 2026-08-02 19:56:08 +08:00
pyproject.toml Trim on retry attempts 2026-08-02 22:03:33 +08:00
README.md Overhaul and optimize codebase, add pre-deployment tests 2026-08-02 19:56:08 +08:00
uv.lock Trim on retry attempts 2026-08-02 22:03:33 +08:00

README.md

Auxos Cloud FastAPI

A simple, barebones API to quickly expose data from your Auxos inverter through a FastAPI interface.

Features

  • 🔋 Real-time Inverter Data: Fetch current inverter status and information
  • 📊 Analytics Data: Access time-series energy production data
  • 📈 Inverter Reports: Get detailed analytics reports from your Auxos inverter
  • 🚀 Docker Ready: Pre-configured for containerized deployment

Requirements

  • Python 3.13 or higher
  • uv (for dependency management)
  • Docker & Docker Compose (for containerized deployment)
  • Auxos Cloud account with inverter credentials

Quick Start

1. Clone the Repository

git clone <repository-url>
cd auxoscloud_fastapi

2. Environment Setup

Create a .env file in the project root with your Auxos credentials:

# Auxos API Configuration
AUXSOL_AUTH_USER=your-email@example.com
AUXSOL_AUTH_PASSWORD=your-password
AUXSOL_INVERTER_ID=your-inverter-id
AUXSOL_INVERTER_SN=your-inverter-serial-number

# Optional: API Configuration
AUXSOL_BASE_URL=https://eu.auxsolcloud.com/auxsol-api
AUXSOL_HOME_URL=https://www.auxsolcloud.com

# Server Configuration
BACKEND_PORT=8000

VERSION=latest

3. Running Locally

Using Python

# Install dependencies
uv sync

# Run the server
uv run fastapi dev --host 0.0.0.0

The API will be available at http://localhost:8000

Using Docker Compose

docker-compose up

Troubleshooting

Connection Issues

  • Verify your Auxos credentials in the .env file
  • Check that your inverter ID and serial number are correct
  • Ensure the Auxos API is accessible from your network