CiteGeist/examples/artificial-life

Artificial Life Topic-Seeding Example

This example shows the smallest useful citegeist workflow that starts from a topic phrase alone.

The seed phrase is:

artificial life

What It Demonstrates

• topic-only bootstrap without a seed .bib;
• previewing ranked candidate seed entries before writing anything;
• storing a curated topic slug, topic name, and expansion phrase in the database;
• running later topic-aware expansion from that stored phrase.

Preview First

Use a preview run to inspect the best candidate seed entries without changing the database:

PYTHONPATH=src .venv/bin/python -m citegeist --db library.sqlite3 \
  bootstrap \
  --topic "artificial life" \
  --topic-slug artificial-life \
  --topic-name "Artificial life" \
  --store-topic-phrase "artificial life alife artificial organisms complex systems evolution simulation" \
  --topic-limit 10 \
  --topic-commit-limit 5 \
  --preview

That returns ranked candidates gathered through the configured resolver/search stack.

Commit The Topic Seeds

Once the preview looks reasonable, run the same bootstrap without --preview:

PYTHONPATH=src .venv/bin/python -m citegeist --db library.sqlite3 \
  bootstrap \
  --topic "artificial life" \
  --topic-slug artificial-life \
  --topic-name "Artificial life" \
  --store-topic-phrase "artificial life alife artificial organisms complex systems evolution simulation" \
  --topic-limit 10 \
  --topic-commit-limit 5

That does three things:

1. finds topic-relevant seed entries;
2. stores them in the bibliography database;
3. creates or updates the artificial-life topic row with the curated expansion phrase.

Inspect The Result

PYTHONPATH=src .venv/bin/python -m citegeist --db library.sqlite3 topics
PYTHONPATH=src .venv/bin/python -m citegeist --db library.sqlite3 topic-entries artificial-life

If you want to adjust the stored phrase later:

PYTHONPATH=src .venv/bin/python -m citegeist --db library.sqlite3 \
  set-topic-phrase artificial-life "artificial life alife artificial organisms autonomous agents evolution simulation"

Optional Batch Form

The same topic-only seed can be expressed as a batch job:

[
  {
    "name": "artificial-life-topic-seed",
    "topic": "artificial life",
    "topic_slug": "artificial-life",
    "topic_name": "Artificial life",
    "topic_phrase": "artificial life alife artificial organisms complex systems evolution simulation",
    "topic_limit": 10,
    "topic_commit_limit": 5,
    "expand": false
  }
]

Run it with:

PYTHONPATH=src .venv/bin/python -m citegeist --db library.sqlite3 bootstrap-batch artificial-life.json

Notes

• This example is intentionally generic and corpus-independent.
• The exact candidate set depends on live source availability and resolver behavior.
• Prefer preview mode before committing topic-only seeds, because topic phrases are noisier than curated seed .bib inputs.