/persona

A Python app that generates random avatars or guide a user to make custom avatars.

Primary LanguagePythonMIT LicenseMIT

Persona

The avatar app of your choice - Visit website

NOTE: No login or signup required. Its free! 🎉

Project snapshots

Screenshot from 2023-12-19 16-35-42

Screenshot from 2023-12-19 16-38-24

Overview

Persona, the ultimate avatar customization experience at your fingertips! Unleash your creativity and bring your virtual identity to life with this cutting-edge app. Customize every detail of your avatar, from hairstyle and facial features to clothing and accessories. With a vast array of options and styles, you can create a unique and personalized representation of yourself or generate random characters.

Persona is user-friendly, intuitive, and ensures a seamless avatar creation process. Express yourself like never before and share your digital persona across social media or use it in your favorite virtual worlds.

Developer Instructions

If you wish to be make contributions, follow the instructions stated below.

  1. Clone this repo to your Desktop or your preferred location using Git.

  2. Make sure you have installed Python interpreter on your machine. If not you can download it on this website Python's official website

  3. Once installed, open the cloned repo (folder) in your terminal/CMD and create a virtual environment using the following command:

    python3 -m venv .venv

  4. Once the virtual environment is created, activate it using the following command:

    source .venv/bin/activate
    
    .venv\Scripts\activate
    
  5. Install project modules using the following command:

    pip install -r requirements.txt

  6. To run the website offline, activate development server using the following command:

    streamlit run main.py

  7. A new tab will be automatically opened on your default browser. The web app runs on localhost:8501

  8. Create a new branch using Git, and make your contributions. Create a pull request and wait for review.

Users instructions

You can access the website on this link and create an avatar today!

Oh! Don't forget to star the repo 😉

Credits

  1. Pyavataaars library

Python component for Avataaars - port of https://github.com/fangpenlin/avataaars

  1. Streamlit

Streamlit — A faster way to build and share data apps.

For more info., click streamlit website