{"id":13492180,"url":"https://github.com/daveshap/ACE_WorldState","last_synced_at":"2025-03-28T09:33:57.016Z","repository":{"id":182818792,"uuid":"669118892","full_name":"daveshap/ACE_WorldState","owner":"daveshap","description":"Microservice that consumes numerous sources to keep track of the global context of Planet Earth. Part of the ACE framework","archived":false,"fork":false,"pushed_at":"2023-07-21T13:26:28.000Z","size":22,"stargazers_count":23,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-22T02:51:17.180Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daveshap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-07-21T11:41:24.000Z","updated_at":"2025-03-10T23:45:02.000Z","dependencies_parsed_at":"2024-01-16T09:01:41.768Z","dependency_job_id":null,"html_url":"https://github.com/daveshap/ACE_WorldState","commit_stats":null,"previous_names":["daveshap/ace_worldstate"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FACE_WorldState","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FACE_WorldState/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FACE_WorldState/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daveshap%2FACE_WorldState/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daveshap","download_url":"https://codeload.github.com/daveshap/ACE_WorldState/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246004225,"owners_count":20708159,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":"2024-07-31T19:01:03.777Z","updated_at":"2025-03-28T09:33:56.717Z","avatar_url":"https://github.com/daveshap.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# ACE WorldState Microservice\n\n## Executive Overview\n\nThe ACE WorldState Microservice is an integral part of the Autonomous Cognitive Entity (ACE) framework. ACE is a pioneering project aimed at creating autonomous systems based on Large Language Models (LLMs) that possess above-human level reasoning, moral discernment, and a range of other sophisticated capabilities.\n\nWithin the ACE framework, the WorldState Microservice plays an essential role. Its primary function is to curate and maintain an up-to-date \"world state\" by collecting news items from various public data sources. This world state data repository informs the Global Strategy layer (L2) of the ACE framework, providing it with the global context required to make strategic decisions.\n\n## Purpose within ACE\n\nThe WorldState Microservice functions as the window to the world for the Global Strategy layer, offering necessary context and updates on global developments. By persistently gathering and storing data from numerous RSS feeds, it provides a reliable source of information to base strategic decisions upon.\n\nThe data retrieved and processed by this microservice also ensures transparency and facilitates out-of-band monitoring. Therefore, it's not only critical for the functioning of the ACE framework but also for the safety and stability of the system.\n\n## Functionality\n\nThis Python-based microservice fetches data from RSS feeds listed in a configuration file and saves the news items to individual YAML files, maintaining a local repository of news items. It also provides a simple REST API that allows users to search these news items based on keyword or date.\n\n## Setup and Usage\n\n### Requirements\n\n- Python 3.x\n- Flask (for the REST API)\n\n### Setup\n\n1. Clone the repository and navigate to the project's root directory.\n2. Install the required Python packages using pip:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n3. Run the `fetch_rss_feeds.py` script to fetch news items from the RSS feeds and save them to YAML files:\n\n    ```bash\n    python fetch_rss_feeds.py\n    ```\n\n    Note: You can modify the list of RSS feeds by editing the `config.yaml` file.\n\n### Running the REST API\n\n1. Start the Flask server by running the `worldstate.py` script:\n\n    ```bash\n    python app.py\n    ```\n\n2. The server will start on `localhost:5000`.\n\n3. You can search the news items by sending a GET request to `http://localhost:5000/search`. Use the `keyword` and `date` query parameters to filter news items by keyword or date. For example, `http://localhost:5000/search?keyword=AI\u0026date=2023-07-22`.\n\n## Conclusion\n\nThe ACE WorldState Microservice is a key building block in the creation of autonomous systems within the ACE framework. It ensures that strategic decisions made by the ACE system are based on the most up-to-date, global information. The WorldState Microservice also provides an excellent example of how LLMs and frontier AI technologies can be harnessed in novel ways to drive innovation in the field of autonomous systems.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaveshap%2FACE_WorldState","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaveshap%2FACE_WorldState","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaveshap%2FACE_WorldState/lists"}