{"id":26246268,"url":"https://github.com/emcd/ai-experiments","last_synced_at":"2026-04-20T20:35:34.571Z","repository":{"id":161322182,"uuid":"634721916","full_name":"emcd/ai-experiments","owner":"emcd","description":null,"archived":false,"fork":false,"pushed_at":"2025-12-12T03:40:28.000Z","size":1942,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-28T09:48:57.177Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emcd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-05-01T02:28:37.000Z","updated_at":"2025-12-12T03:40:32.000Z","dependencies_parsed_at":"2023-07-26T02:31:32.137Z","dependency_job_id":"4555fc58-1639-46eb-94d0-5f8fa446d7ba","html_url":"https://github.com/emcd/ai-experiments","commit_stats":null,"previous_names":["emcd/ai-experiments"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/emcd/ai-experiments","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emcd%2Fai-experiments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emcd%2Fai-experiments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emcd%2Fai-experiments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emcd%2Fai-experiments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emcd","download_url":"https://codeload.github.com/emcd/ai-experiments/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emcd%2Fai-experiments/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32065045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-13T13:17:45.444Z","updated_at":"2026-04-20T20:35:34.553Z","avatar_url":"https://github.com/emcd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Contains an application to interact with various AI providers, plus some\nutilities to scrape data from the web and ingest into vector databases.\n\n# Use\n\nNOTE: Please read the installation and configuration instructions before use.\n\nCurrently, there is no installable package, but you can run the application\nvia Hatch:\n```\nhatch run aiwb\n```\n\n# Installation\n\n## Initial Installation\n\nCurrently, there is no installable package. But, the application can be setup\nto run from a virtual environment without too much hassle by following these\nsteps:\n\n1. Ensure that you have installed [Git LFS](https://git-lfs.com/).\n1. Clone this repository.\n1. Ensure that you have installed\n   [Pipx](https://github.com/pypa/pipx/blob/main/README.md#install-pipx).\n   (If installing via `pip`, you will want to use your system Python rather\n   than the current global Python provided by Asdf, Mise, Pyenv, etc....)\n1. Ensure that you have installed\n   [Hatch](https://github.com/pypa/hatch/blob/master/README.md) via Pipx:\n   ```\n   pipx install hatch\n   ```\n\n## Installation Updates\n\n1. Run:\n   ```\n   git pull\n   ```\n1. Remove possibly-stale virtual environments:\n   ```\n   hatch env prune\n   ```\n\nThe `default` virtual environment will be automatically rebuilt next time the\napplication is run via Hatch. You may need to run something in the `develop`\nvirtual environment to rebuild it too, if you have installed Git hooks which\nrely upon it.\n\n# Configuration\n\n## General\n\nA file, named `general.toml`, located in the user configuration directory for\nthe application, on first run. The user configuration directory varies by\nplatform:\n* MacOS:\n* Windows:\n* XDG (Linux distributions, etc...): `~/.config/aiwb`\nThis file includes configurations for your AI providers, switches to enable or\ndisable special functionality, and the locations where your environment,\nprompts, and conversations are stored.\n\n## Environment\n\nEnvironment variables are loaded from one of the following files:\n1. An `.env` file in your current working directory.\n1. An `.env` file in the same directory as this README.\n1. The location from the `environment-file` entry in the general configuration\n   (see above). By default, this is a file, named `environment`, in the user\n   configuration directory.\nThe files are considered in the above order and only the first that exists is a\nsource for environment variables. The remainder are ignored.\n\nWarning: If you keep your home directory, or pieces of it, in version control,\nand you have an environment file in the user configuration directory for the\napplication, then you probably want to add the file location to `.gitignore`,\nor equivalent, to avoid exposing sensitive credentials.\n\n## AI Providers\n\n### OpenAI\n\n1. Add your OpenAI API key to the environment file as follows:\n   ```\n   OPENAI_API_KEY=\u003cyour OpenAI API key\u003e\n   ```\n1. If you have an OpenAI organization ID, you can add it to the environment\n   file:\n   ```\n   OPENAI_ORG_ID=\u003cyour organization ID\u003e\n   ```\n1. If you have an OpenAI project ID, you can add it to the environment file:\n   ```\n   OPENAI_PROJECT_ID=\u003cyour project ID\u003e\n   ```\n\n# Development\n\nIf you intend to develop on this project (i.e., enhance the library, rather\nthan simply use it), then please consider the following suggestions.\n\n## Installation\n\n1. Install Git pre-commit and pre-push hooks:\n   ```\n   hatch --env develop run pre-commit install --config .auxiliary/configuration/pre-commit.yaml\n   ```\n   and validate the installation with:\n   ```\n   hatch --env develop run pre-commit run --config .auxiliary/configuration/pre-commit.yaml --all-files\n   ```\n\n## Editor Environment\n\nYou may want to run your editor from inside a Hatch-prepared shell environment\nto ensure that any online linters or language servers have access to the\ncorrect set of Python packages:\n```\nhatch --env develop shell\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femcd%2Fai-experiments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femcd%2Fai-experiments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femcd%2Fai-experiments/lists"}