Quickstart

Greppilot is an AI-powered analytics dashboard that enables natural language interaction with your data. This quickstart guide outlines the initial setup process to configure your LLM and connect your first data source.

Greppilot onboarding flow: selecting an LLM mode, configuring an LLM API key, and connecting a data integration.

LLM Configuration

The first step in setting up Greppilot is to configure your Large Language Model (LLM). You have two primary options:

  • Bring Your Own Key (BYOK): Recommended for enhanced privacy and control. With BYOK, you provide your own Anthropic (Claude) API key. This key is stored locally in your browser and used to authenticate requests to the LLM provider.
  • Managed: Utilize Greppilot's managed LLM service. This option requires no direct API key configuration from your side.

If you select 'Bring Your Own Key' (BYOK), your LLM API key is stored locally in your browser and sent securely with each request. It is never stored on Greppilot servers.

Connect a Data Integration

Greppilot interacts with your data sources through integrations. Each integration provides a set of namespaced tools that the AI agent can autonomously discover and use to query, analyze, and visualize your data.

To connect an integration, select its type and provide the required configuration parameters. Connection details are encrypted and stored securely.

Common integration types and their configurations include:

PostgreSQL

ParameterTypeRequiredDescription
connectionStringstringYesFull PostgreSQL connection URI. Example: postgresql://user:pass@host:5432/db

PostHog

ParameterTypeRequiredDescription
apiKeystringYesYour PostHog project API key.
projectIdstringYesThe numeric ID of your PostHog project.
hoststringNoThe base URL of your PostHog instance. Defaults to https://us.posthog.com.

CSV Upload

For CSV files, you will be prompted to upload your .csv file directly. Greppilot processes and stores this data, making it available for immediate AI interaction. No explicit configuration fields are required for CSV.

Next Steps

Once your LLM is configured and at least one data integration is connected, you can navigate to your dashboard. Begin conversing with the AI agent to query your data, generate insights, create charts, and build custom analytical dashboards.

See also: BYOK Setup for detailed LLM key configuration, and Your First Query to start querying your data.