oaifree-helper  by jyx04

Helper for shared access to mirrored service

created 1 year ago
251 stars

Top 99.8% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a Cloudflare Worker-based helper for accessing the new.oaifree.com mirror site, enabling users to share access to tokens and manage usage. It targets users who need a streamlined way to access shared AI services without managing their own infrastructure, offering features like direct login, user management, and token pooling.

How It Works

The core of the project leverages Cloudflare Workers and KV storage to manage user sessions, store and refresh access/refresh tokens, and interact with the linuxdo mirror site's API. It acts as a proxy, distributing shared tokens and enforcing user-defined limits, all without requiring a dedicated server or domain. The architecture supports multiple deployment options, including a one-click setup for all components.

Quick Start & Requirements

  • Primary install/run: Deploy Cloudflare Worker (one-click or manual).
  • Prerequisites: Cloudflare account, linuxdo account with sufficient privileges for token generation. Optional: Turnstile for bot protection, custom domain.
  • Setup: One-click deployment is designed for ease of use. Manual setup involves configuring Cloudflare Workers, KV namespaces, and environment variables.
  • Links: GitHub Project

Highlighted Details

  • One-click deployment for main service, selection panel, and API service.
  • Supports direct login via URL (/?un=xxx).
  • Token pooling with automatic refresh and invalid token detection.
  • Multiple car selection modes (manual, specific user, round-robin, random).
  • Admin panel for user management, token management, usage queries, and token export.
  • Optional integration with Turnstile for bot protection.
  • Optional API service for Plus accounts.
  • Optional voice service reverse proxy.
  • Optional content moderation integration.

Maintenance & Community

  • Actively maintained with recent updates including token export, voice service proxy, and content moderation integration.
  • Bug reports and feature requests are handled via GitHub Issues.

Licensing & Compatibility

  • The project is primarily distributed under a permissive license, but its functionality is dependent on linuxdo services, which may have their own terms of use. Compatibility with commercial or closed-source applications is not explicitly detailed but relies on the underlying linuxdo service.

Limitations & Caveats

  • The project is heavily dependent on the linuxdo mirror site; users without sufficient linuxdo privileges may find it unusable.
  • KV storage usage can impact performance and incur costs if not managed carefully, especially with frequent calls for personalization.
  • Some features like custom avatars or moderation require additional API keys and may increase KV usage.
Health Check
Last commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
4 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.