Skip to main content

Create and analyze LLM-based surveys

Project description

Expected Parrot Domain-Specific Language

edsl.png

The Expected Parrot Domain-Specific Language (EDSL) package lets you conduct computational social science and market research with AI. Use it to design surveys and experiments, simulate responses with large language models, and perform data labeling and other research tasks. Results are formatted as specified datasets and come with built-in methods for analyzing, visualizing, and sharing.

๐Ÿ”— Links

๐ŸŒŽ Hello, World!

A quick example:

# Import a question type
from edsl import QuestionMultipleChoice

# Construct a question using the question type template
q = QuestionMultipleChoice(
    question_name="example_question",
    question_text="How do you feel today?",
    question_options=["Bad", "OK", "Good"]
)

# Run it with the default language model
results = q.run()

# Inspect the results in a dataset
results.select("example_question").print()

Output:

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ answer            โ”ƒ
โ”ƒ .example_question โ”ƒ
โ”กโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ฉ
โ”‚ Good              โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ’ป Requirements

  • EDSL is compatible with Python 3.9 - 3.12.
  • API keys for large language models that you want to use, stored in a .env file. See instructions on storing API keys.

๐Ÿ’ก Contributions, feature requests & bugs

Interested in contributing? Want us to add a new feature? Found a bug for us to squash? Please send us an email at info@expectedparrot.com or message us at our Discord channel.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

edsl-0.1.37.tar.gz (322.2 kB view details)

Uploaded Source

Built Distribution

edsl-0.1.37-py3-none-any.whl (426.1 kB view details)

Uploaded Python 3

File details

Details for the file edsl-0.1.37.tar.gz.

File metadata

  • Download URL: edsl-0.1.37.tar.gz
  • Upload date:
  • Size: 322.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.7 Darwin/23.6.0

File hashes

Hashes for edsl-0.1.37.tar.gz
Algorithm Hash digest
SHA256 b4c1748b2d51ec4af5ee70fbb892906a2fe082f8d7a524f80facd0b56b52de5f
MD5 2a6c7ac1a730a25f1adca8eb10e1dd12
BLAKE2b-256 96ebb5a45b3cbc8302a66ba3b9076fc0c483775b951e60e60b06f329ae232b94

See more details on using hashes here.

File details

Details for the file edsl-0.1.37-py3-none-any.whl.

File metadata

  • Download URL: edsl-0.1.37-py3-none-any.whl
  • Upload date:
  • Size: 426.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.7 Darwin/23.6.0

File hashes

Hashes for edsl-0.1.37-py3-none-any.whl
Algorithm Hash digest
SHA256 5bdcce8e45b7418423c0046a94b7380cc75ee6d2ac8960c85e9827be92ee244d
MD5 393dfd23c30fc7a6ad4627220e8d45c3
BLAKE2b-256 b0cdb3b028dc01451ccbc50205441114dc6cb067f15357871536b1414f68924a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page