# Free_ApiManager

**Repository Path**: IkunWindow/free_-api-manager

## Basic Information

- **Project Name**: Free_ApiManager
- **Description**: 一个致力于提供免费API管理服务的开源项目，支持API的创建、测试与文档生成，旨在为开发者简化API开发流程。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2026-03-01
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="封面.png" alt="LLM API Manager" width="600">
</p>

<p align="center">
  <strong>🔐 All-in-One API Key Management Platform (Open Source)</strong>
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" alt="License"></a>
  <a href="#"><img src="https://img.shields.io/badge/Python-3.10+-blue.svg" alt="Python"></a>
  <a href="#"><img src="https://img.shields.io/badge/FastAPI-0.115+-green.svg" alt="FastAPI"></a>
  <img src="https://img.shields.io/badge/Database-SQLite%20%7C%20PostgreSQL-orange" alt="Database">
</p>

<p align="center">
  <strong>⚡ Deploy in 3 Minutes</strong> · No Database Required · Ready to Use
</p>

<p align="center">
  <a href="README.md">简体中文</a> | <strong>English</strong>
</p>

---

## ✨ Features

- 🚀 **Quick Deploy** — One-click installation script, no manual configuration
- 💾 **Zero Dependencies** — SQLite by default, no database installation needed
- 🔐 **Bank-level Encryption** — AES-256 encrypted storage, keys never in plaintext
- 🏷️ **Preset Providers** — Supports OpenAI, Claude, Gemini, DeepSeek and 10+ platforms
- 🔒 **Two-Factor Auth** — TOTP secondary verification support
- 📱 **Responsive Design** — Support for mobile, tablet, and desktop

---

## ⚡ Quick Start

### Windows

```powershell
# 1. Clone the project
git clone https://github.com/your-username/api-key-manager.git
cd api-key-manager

# 2. One-click install (Right-click -> Run with PowerShell)
.\install.ps1

# 3. Start the service
.\start.ps1

# 4. Visit http://localhost:8001
```

### Linux / Mac

```bash
# 1. Clone the project
git clone https://github.com/your-username/api-key-manager.git
cd api-key-manager

# 2. One-click install
chmod +x install.sh && ./install.sh

# 3. Start the service
./start.sh

# 4. Visit http://localhost:8001
```

---

## 🐳 Docker Deployment

### Option 1: SQLite Mode (Recommended for Personal Use)

```bash
# One-click start (simplest)
docker-compose -f docker-compose.sqlite.yml up -d

# Visit http://localhost:8001
# Data stored in ./data/api_manager.db
```

### Option 2: PostgreSQL Mode (Recommended for Production)

```bash
# 1. Create config file
cp .env.example .env

# 2. Edit .env and set required environment variables
# - DATABASE_URL=postgresql://user:password@db:5432/api_manager
# - SECRET_KEY=your-secret-key
# - ENCRYPTION_KEY=your-encryption-key
# - ENCRYPTION_SALT=your-encryption-salt

# 3. Start services
docker-compose up -d

# 4. Visit http://localhost:80
```

---

## 🔧 Features List

### Core Features

| Feature | Description |
|---------|-------------|
| 🔑 API Key Management | Encrypted storage, group management, expiration reminders |
| 🏷️ Preset Providers | OpenAI, Claude, Gemini, DeepSeek, etc. |
| 🔐 TOTP Authentication | Support for Google Authenticator, etc. |
| 🌐 OpenAI Compatible API | Standard interface, supports all compatible clients |
| 📊 Usage Statistics | Token usage, cost statistics |
| 📝 Operation Logs | Complete operation audit records |
| 🔔 Login Notifications | Email notifications for remote logins |

### Advanced Features

| Feature | Description |
|---------|-------------|
| 🎫 Access Tokens | Generate shareable API access keys |
| 📱 Single Device Login | Kick out other devices for account security |
| 🔒 Account Lock | Emergency account lock to prevent unauthorized access |
| 🛡️ Security Settings | Login notifications, remote login verification |

---

## 📄 License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This means:
- ✅ Free to use, modify, and distribute
- ✅ Must retain original author copyright notice
- ✅ Modified versions must be open-sourced under the same license
- ✅ Network service usage also requires providing source code

See [LICENSE](LICENSE) file for details.

---

## 🙏 Acknowledgements

Thanks to all contributors!