AI agent guidance for working with the Gig Fusion concert events project. Provides setup, data flow, Meilisearch indexing patterns, and repo conventions for scraping and searching concert events.
AI agent guidance for working with the Gig Fusion concert events project. This skill helps you understand the data flow, setup process, and conventions for the gig-fusion repository.
1. **Scrapers/parsers** produce JSON files named `concert_events_*.json` at the repo root
2. **Notebooks** read the latest JSON via `load_latest_events()` (see `ingest.ipynb`)
3. **Events** are pushed to a local Meilisearch index named `events`
4. **Search backend** stores indexes under `data/data.ms/` (persistent data - do not delete)
```bash
conda env create -f environment.yml
conda activate eventing
```
```bash
docker run --rm -it -p 7700:7700 \
-v "$PWD/data/data.ms:/data.ms" \
-e MEILI_MASTER_KEY="<your-key>" \
getmeili/meilisearch:latest \
meilisearch --db-path /data.ms --master-key "$MEILI_MASTER_KEY"
```
Open `ingest.ipynb` in JupyterLab and run the cells to index the latest `concert_events_*.json` into the `events` index.
Code in `ingest.ipynb` follows this pattern:
```python
index.add_documents(events, primary_key="id")
index.update_searchable_attributes([...])
index.update_filterable_attributes([...])
index.update_sortable_attributes([...])
```
When adding new fields, update all three attribute lists as appropriate.
```python
import os
import meilisearch
client = meilisearch.Client(
os.getenv('MEILI_URL', 'http://localhost:7700'),
os.getenv('MEILI_API_KEY')
)
```
Faceted search from `ingest.ipynb`:
```python
facet_fields = ["location", "status_kind", "price_eur", "date", "band"]
result = index.search(
"sonic",
{
"filter": 'price_eur < 50 AND status_kind != "ausverkauft"',
"facets": facet_fields,
"sort": ["date:desc"],
"limit": 1000,
}
)
```
If you find hard-coded API keys in notebooks:
1. Replace with environment variable lookups: `os.getenv('MEILI_API_KEY')`
2. Document the change in the commit message
3. Recommend the user add the key to their environment or `.env` file
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/gig-fusion-event-search/raw