Skip to main content
This guide walks you through running your first project from the Awesome AI Apps collection. You will clone the repository, enter a project directory, configure your API keys, install dependencies, and run the app. Most projects are ready to run in under five minutes.

​
Prerequisites

Before you begin, make sure you have the following installed:
  • Python 3.10+ (Python 3.11+ is recommended for newer projects)
  • Git
  • pip or uv (uv is recommended for faster installs)
  • API keys for the services used by your chosen project (check the individual project READMEs)
1

Clone the repository

Clone the Awesome AI Apps repository from GitHub to your local machine.
2

Choose a project and navigate to it

Each project lives in its own subdirectory. Pick one to start with. For example, the Agno HackerNews starter:
3

Set up environment variables

Copy the example environment file and add your API keys.
Open .env in your editor and fill in the required keys for your project.
4

Install dependencies

You can install dependencies with either pip or uv.
5

Run the project

Start the app using the command provided in the project’s README.
If you are unsure which project to start with, try the Starter Agents section. These projects are built to demonstrate core framework patterns with minimal configuration.