index

Simplify OAuth2 Authentication

---

---

If you're experiencing any issues or have suggestions, please record your screen and submit it here! This helps us understand your problem better and resolve it more efficiently.

---

Omni-Authify is a Python library that makes OAuth2 authentication a breeze across multiple frameworks and providers. Its main goal is to give you a unified and easy-to-use interface for adding social logins to your applications.

✨ Features

• 🌍 Multiple Providers: Currently supports Facebook OAuth2 authentication, with more to come.

• 🔧 Framework Integration: Works seamlessly with Django, Django REST Framework (DRF), FastAPI and Flask.

• ⚡ Easy to Use: Requires minimal setup to get started.

• 🚀 Extensible: Designed to support more providers and frameworks as your needs grow.

---

🚀 Usage Examples

Follow the example below to quickly integrate Omni-Authify into your application.

from omni_authify.providers import Facebook, GitHub


# ==== Initialize the Facebook provider ====
facebook_provider = Facebook(
    client_id='your-client-id',
    client_secret='your-client-secret',
    redirect_uri='your-redirect-uri'
)
# Get authorization URL
facebook_auth_url = facebook_provider.get_authorization_url(state='your-state')
# After redirect and code exchange
facebook_access_token = facebook_provider.get_access_token(code='authorization-code')
# Fetch user profile
facebook_user_info = facebook_provider.get_user_profile(facebook_access_token, fields='your-fields')



# ==== Initialize the GitHub provider ====
github_provider = GitHub(
    client_id='🔑 your-facebook-client-id', 
    client_secret='🔒 your-facebook-client-secret',
    redirect_uri='🌐 your-facebook-redirect-uri',
    scope="user,repo"
)
# Get authorization URL
github_auth_url = github_provider.get_authorization_url(state='your-state')
# After redirect and code exchange
github_access_token = github_provider.get_access_token(code='authorization-code')
# Fetch user profile
github_user_info = github_provider.get_user_profile(github_access_token)

---

🛠️ Installation Guide

Check out the full installation guide - Installation for detailed instructions on how to add Omni-Authify to your project.

📜 Supported Providers and Frameworks

Omni-Authify currently supports Facebook, GitHub OAuth2 and integrates smoothly with Django, Django REST Framework (DRF), FastAPI and Flask. For a list of all supported providers and more details, check - Supported Providers and Frameworks.

🔐 License

This project is licensed under the MIT License. See the 📚- License for more information.

---

Omni-Authify is your go-to solution for easy social login integration, whether you're building a simple python project or scaling up with Django, DRF or other frameworks like FastAPI or Flask. Give it a spin and enjoy smooth OAuth2 authentication!