wtf is belief-agent?

Belief-Agent is a Python library that adds explicit, trackable beliefs on top of any LLM agent. The problem it addresses is that ordinary LLM agents tend to answer confidently based on whatever pattern matches the conversation, without any real memory of what they previously said or any way to notice when they contradict themselves. Belief-Agent tries to fix that by storing what an agent believes as actual data, rather than leaving it hidden inside the model's weights. The library adds three layers on top of a language model. The first, called BeliefState, is a structured store of beliefs, each with a confidence score between 0 and 1, supporting evidence, any known contradictions, tags, and timestamps. The second, reflection, runs a self-critique loop that reviews existing beliefs, checks them against a language model again, and updates their confidence when contradictions or new evidence appear, either automatically or with a human approving the change. The third, negotiation, lets multiple agents with different goals rank their priorities, analyze tradeoffs, and generate a compromise when their objectives conflict. In practice, you wrap any LLM call, whether that is OpenAI, Claude, a local model, or something else through the LiteLLM integration, inside a BeliefAgent object. You can then have the agent adopt beliefs with a stated confidence level, chat with it normally while its current beliefs get injected into every prompt, and call a reflection function to have it re-examine and update its own beliefs, printing out how each belief's confidence changed and why. Beliefs can be listed, searched by keyword or tag, and serialized to and from JSON so an agent's memory can be saved and restored. The project requires Python 3.10 or later, is installable from PyPI, and its README states it ships with 62 passing tests and 78 percent test coverage. It is released under the MIT License, meaning it can be used, modified, and redistributed freely, including in commercial projects, as long as the license notice is kept.