ProxyCLI / conductor /tech-stack.md
PHhTTPS's picture
conductor(setup): Add conductor setup files
298442c
# Technology Stack
## Core Development
* **Primary Language:** Go 1.23 (with Go 1.24.11 toolchain support)
* **Web Framework:** [Gin Gonic](https://github.com/gin-gonic/gin) - Used for high-performance HTTP routing and middleware.
* **Websockets:** [Gorilla Websocket](https://github.com/gorilla/websocket) - For real-time communication relay.
## Data & Storage
* **Database:** PostgreSQL - Accessed via the [pgx/v5](https://github.com/jackc/pgx) driver for efficient, native PostgreSQL support.
* **Object Storage:** [MinIO Go SDK](https://github.com/minio/minio-go) - For interacting with S3-compatible storage.
## Infrastructure & Deployment
* **Containerization:** Docker - Primary deployment method, with specific optimizations for Hugging Face Spaces.
* **Deployment Platforms:** Hugging Face Spaces, Puter OS.
* **CI/CD:** GitHub Actions (defined in `.github/workflows/`) for Docker image building and releases.
## Utilities & Libraries
* **Configuration:** YAML (via `gopkg.in/yaml.v3`) and environment variables (via `joho/godotenv`).
* **Logging:** [Logrus](https://github.com/sirupsen/logrus) for structured logging, with [Lumberjack](https://github.com/natefinch/lumberjack) for log rotation.
* **File Watching:** [fsnotify](https://github.com/fsnotify/fsnotify) - Used for real-time configuration or state monitoring.
* **Git Integration:** [go-git](https://github.com/go-git/go-git) - For programmatic Git operations.
* **Tokenization:** [tiktoken-go](https://github.com/tiktoken-go/tokenizer) - For accurate token counting across different model families.