Expand description
Jnana — the foundation of knowing
Jnana (Sanskrit: ज्ञान — knowledge, wisdom) is the unified knowledge system for AGNOS. It distills human understanding into structured, tested, queryable, offline-accessible data — drawing from AGNOS science crates and curated external sources.
§Philosophy
Wikipedia is 50GB of prose. Jnana is 1-10GB of proven, testable, executable knowledge. Every formula is verified by a test. Every constant comes from an authoritative source. Every procedure works.
§Knowledge Sources
Internal (from AGNOS crates — distilled, tested):
- hisab: math formulas, linear algebra, calculus, geometry
- kimiya: periodic table, reactions, thermochemistry
- tanmatra: particle physics, nuclear data, spectral lines
- prakash: optics tables, spectral data, Fresnel equations
- pramana: probability distributions, statistical methods
- bodh: cognitive models, psychophysics laws
- vidya: programming best practices across languages
- …every science crate’s reference data
External (curated, downloaded, verified):
- Medical references (WikiMed, field medicine guides)
- Survival procedures (shelter, water, food, navigation)
- Repair guides (iFixit, practical how-to)
- Agricultural science (FAO, permaculture, aquaponics)
- Construction (earthbag, timber, solar, plumbing)
§Modules
domain— Knowledge domains and their entriesentry— Core types:Entry,Fact,Procedure,Constant,Tableregistry— In-memory knowledge registry with lookup and searchprofile— Storage profiles (survival, homesteader, developer, educator, full)search— Cross-domain searchsource— External source management (download, verify, update)portal— Web portal generation from registrystorage— Budget calculator, what-fits analysiserror— Error types
§Example
use jnana::{Registry, SearchQuery};
let registry = Registry::new();
if let Some(entry) = registry.get("speed_of_light") {
println!("{}: {}", entry.title, entry.summary);
}
let results = jnana::search::search(®istry, &SearchQuery::text("binding energy"));Re-exports§
pub use domain::Domain;pub use entry::Constant;pub use entry::Entry;pub use entry::EntryKind;pub use entry::Fact;pub use entry::Procedure;pub use entry::Table;pub use error::JnanaError;pub use error::Result;pub use profile::Profile;pub use provider::KnowledgeProvider;pub use registry::Registry;pub use search::SearchQuery;pub use search::SearchResult;pub use source::Source;pub use storage::StorageBudget;
Modules§
- content
- Content pipeline — load sources and profiles from TOML files.
- domain
- Knowledge domains — the top-level organization of human understanding.
- entry
- Core knowledge entry types.
- error
- Error types for jnana.
- linker
- Cross-crate knowledge linking.
- portal
- Web portal generation from registry and sources.
- profile
- Storage profiles — presets for different use cases.
- provider
- Knowledge provider trait for AGNOS crate integration.
- providers
- Built-in knowledge providers for AGNOS science crates.
- registry
- In-memory knowledge registry.
- search
- Cross-domain knowledge search.
- source
- External source management — download, verify, update.
- storage
- Storage budget calculator.