GETTING_STARTED.md

Firebase Setup

To set up Firebase, follow these steps:

1. Create a Firebase Project: Go to Firebase Console and create a new project.
2. Generate a Service Account Key:
   • Click on Project Overview from the sidebar.
   • Open the Service Accounts tab.
   • Click on the option to generate a new private key in the Firebase Admin SDK sub-section.
   • Read the warning and generate the key. Rename the downloaded key to firebase_service_account.json and move it to the root of the potpie source code.

---

Portkey Integration

Portkey provides observability and monitoring capabilities for AI integration with Potpie.

• Sign Up: Create a free account at Portkey and keep your API key in .env as PORTKEY_API_KEY.

---

Setting Up GitHub App

To enable login via GitHub, create a GitHub app by following these steps:

1. Visit GitHub App Creation.
2. Name Your App: Choose a name relevant to Potpie (e.g., potpie-auth).
3. Set Permissions:
   • Repository Permissions:
     • Contents: Read Only
     • Metadata: Read Only
     • Pull Requests: Read and Write
     • Secrets: Read Only
     • Webhook: Read Only
   • Organization Permissions: Members : Read Only
   • Account Permissions: Email Address: Read Only
4. Generate a Private Key: Download the private key and add it to env under GITHUB_PRIVATE_KEY. Add your app ID to GITHUB_APP_ID.
5. Install the App: From the left sidebar, select Install App and install it next to your organization/user account.

---

Enabling GitHub Auth on Firebase

1. Open Firebase and navigate to Authentication.
2. Enable GitHub sign-in capability by adding a GitHub OAuth app from your account. This will provide you with a client secret and client ID to add to Firebase.
3. Copy the callback URL from Firebase and add it to your GitHub app. GitHub Auth with Firebase is now ready.

---

Google Cloud Setup

Potpie uses Google Secret Manager to securely manage API keys. If you created a Firebase app, a linked Google Cloud account will be automatically created. You can use that or create a new one as needed. Follow these steps to set up the Secret Manager and Application Default Credentials (ADC) for Potpie:

1. Set up the Secret Manager.
2. Configure Application Default Credentials for local use. Once completed, you are ready to proceed with the Potpie setup.

---

Running Potpie

1. Ensure Docker is Installed: Verify that Docker is installed and running on your system.
2. Set Up the Environment: Create a .env file based on the provided .env.template in the repository. This file should include all necessary configuration settings for the application.
3. Google Cloud Authentication: Log in to your Google Cloud account and set up Application Default Credentials (ADC). Detailed instructions can be found in the documentation. Alternatively place the service account key file for your gcp project in service-account.json file in the root of the codebase.
4. Run Potpie: Execute the following command:

   ./start.sh

   You may need to make it executable by running:

   chmod +x start.sh

API Workflow Guide

Prerequisites

1. Ensure the API server is running and accessible at http://localhost:8001.
2. Have curl installed on your machine to execute the API requests.

Step 1: Logging in to get a bearer token

curl -X 'POST' \
  'http://localhost:8001/api/v1/login' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "string",
  "password": "string"
}'

Step 2: Submit a Parsing Request

Replace the repo name and branch name with the repo you want to talk to.

curl -X 'POST' \
  'http://localhost:8001/api/v1/parse' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "repo_name": "vineetshar/mongo-proxy12",
  "branch_name": "main"
}'

Step 3: Check Parsing Status

Use the project id generated from previous request.

curl -X 'GET' \
  'http://localhost:8001/api/v1/parsing-status/project-id' \
  -H 'accept: application/json'

Step 4: List Available Agents

curl -X 'GET' \
  'http://localhost:8001/api/v1/list-available-agents/?list_system_agents=true' \
  -H 'accept: application/json'

Step 5: Create a Conversation

curl -X 'POST' \
  'http://localhost:8001/api/v1/conversations/' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "user_id": "your_user_id",
  "title": "Conversation Title",
  "status": "active",
  "project_ids": [
    "project_id"
  ],
  "agent_ids": [
    "agent_id"
  ]
}'

Step 6: Send Messages in a Conversation

This API returns a stream response for the

curl -X 'POST' \
  'http://localhost:8001/api/v1/conversations/1234/message/' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "content": "Your message content here",
  "node_ids": [
    {
      "node_id": "node_identifier",
      "name": "node_name"
    }
  ]
}'

Step 7: Get all the messages of a conversation

curl -X 'GET' \
  'http://localhost:8001/api/v1/conversations/conversation-id/
  messages/?start=0&limit=10' \
  -H 'accept: application/json'

Additional Information

For more details on additional API endpoints and comprehensive documentation, visit docs.potpie.ai

Summary

1. Submit a Parsing Request: Initiate parsing of a repository.
2. Check Parsing Status: Monitor the progress until parsing is complete.
3. List Available Agents: Retrieve agents to interact with.
4. Create a Conversation: Start a new conversation session.
5. Send Messages: Communicate within the created conversation.